1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
// Copyright (c) 2011 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef PPAPI_THUNK_ENTER_H_
#define PPAPI_THUNK_ENTER_H_
#include "base/basictypes.h"
#include "ppapi/c/pp_resource.h"
#include "ppapi/proxy/interface_id.h"
#include "ppapi/shared_impl/function_group_base.h"
#include "ppapi/shared_impl/resource_object_base.h"
#include "ppapi/shared_impl/tracker_base.h"
namespace ppapi {
namespace thunk {
// EnterHost* helper objects: These objects wrap a call from the C PPAPI into
// the internal implementation. They make sure the lock is acquired and will
// automatically set up some stuff for you.
//
// You should always check whether the enter succeeded before using the object.
// If this fails, then the instance or resource ID supplied was invalid.
//
// The |report_error| arguments to the constructor should indicate if errors
// should be logged to the console. If the calling function expects that the
// input values are correct (the normal case), this should be set to true. In
// some case like |IsFoo(PP_Resource)| the caller is quersioning whether their
// handle is this type, and we don't want to report an error if it's not.
//
// Standalone functions: EnterHostFunction
// Automatically gets the implementation for the function API for the
// supplied PP_Instance.
//
// Resource member functions: EnterHostResource
// Automatically interprets the given PP_Resource as a resource ID and sets
// up the resource object for you.
template<typename FunctionsT>
class EnterFunction {
public:
EnterFunction(PP_Instance instance, bool report_error)
: functions_(NULL) {
FunctionGroupBase* base = TrackerBase::Get()->GetFunctionAPI(
instance, FunctionsT::interface_id);
if (base)
functions_ = base->GetAs<FunctionsT>();
// TODO(brettw) check error and if report_error is set, do something.
}
~EnterFunction() {}
bool succeeded() const { return !!functions_; }
bool failed() const { return !functions_; }
FunctionsT* functions() { return functions_; }
private:
FunctionsT* functions_;
DISALLOW_COPY_AND_ASSIGN(EnterFunction);
};
// Like EnterResource but assumes the lock is already held.
// TODO(brettw) actually implement locks, this is just a placeholder for now.
template<typename FunctionsT>
class EnterFunctionNoLock : public EnterFunction<FunctionsT> {
public:
EnterFunctionNoLock(PP_Instance instance, bool report_error)
: EnterFunction<FunctionsT>(instance, report_error) {
// TODO(brettw) assert the lock is held.
}
};
template<typename ResourceT>
class EnterResource {
public:
EnterResource(PP_Resource resource, bool report_error)
: object_(NULL) {
ResourceObjectBase* base = TrackerBase::Get()->GetResourceAPI(resource);
if (base)
object_ = base->GetAs<ResourceT>();
// TODO(brettw) check error and if report_error is set, do something.
}
~EnterResource() {}
bool succeeded() const { return !!object_; }
bool failed() const { return !object_; }
ResourceT* object() { return object_; }
private:
ResourceT* object_;
DISALLOW_COPY_AND_ASSIGN(EnterResource);
};
// Like EnterResource but assumes the lock is already held.
// TODO(brettw) actually implement locks, this is just a placeholder for now.
template<typename ResourceT>
class EnterResourceNoLock : public EnterResource<ResourceT> {
public:
EnterResourceNoLock(PP_Resource resource, bool report_error)
: EnterResource<ResourceT>(resource, report_error) {
// TODO(brettw) assert the lock is held.
}
};
} // namespace thunk
} // namespace ppapi
#endif // PPAPI_THUNK_ENTER_H_
|