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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
/* Copyright 2013 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.
*/
/**
* This file defines the API for output protection. Currently, it only supports
* Chrome OS.
*/
[generate_thunk]
label Chrome {
M31 = 0.1
};
/**
* Content protection methods applied on video output link.
*/
[assert_size(4)] enum PP_OutputProtectionMethod_Private {
PP_OUTPUT_PROTECTION_METHOD_PRIVATE_NONE = 0,
PP_OUTPUT_PROTECTION_METHOD_PRIVATE_HDCP = 1 << 0
};
/**
* Video output link types.
*/
[assert_size(4)] enum PP_OutputProtectionLinkType_Private {
PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_NONE = 0,
PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_UNKNOWN = 1 << 0,
PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_INTERNAL = 1 << 1,
PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_VGA = 1 << 2,
PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_HDMI = 1 << 3,
PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_DVI = 1 << 4,
PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_DISPLAYPORT = 1 << 5,
PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_NETWORK = 1 << 6
};
/**
* The <code>PPB_OutputProtection_Private</code> interface allows controlling
* output protection.
*
* <strong>Example:</strong>
*
* @code
* op = output_protection->Create(instance);
* output_protection->QueryStatus(op, &link_mask, &protection_mask,
* done_callback);
* @endcode
*
* In this example, the plugin wants to enforce HDCP for HDMI link.
* @code
* if (link_mask & PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_HDMI) {
* output_protection->EnableProtection(
* op, PP_OUTPUT_PROTECTION_METHOD_PRIVATE_HDCP, done_callback);
* }
* @endcode
*
* After EnableProtection() completes, the plugin has to query protection
* status periodically to make sure the protection is enabled and remains
* enabled.
*/
interface PPB_OutputProtection_Private {
/**
* Create() creates a new <code>PPB_OutputProtection_Private</code> object.
*
* @pram[in] instance A <code>PP_Instance</code> identifying one instance of
* a module.
*
* @return A <code>PP_Resource</code> corresponding to a
* <code>PPB_OutputProtection_Private</code> if successful, 0 if creation
* failed.
*/
PP_Resource Create([in] PP_Instance instance);
/**
* IsOutputProtection() determines if the provided resource is a
* <code>PPB_OutputProtection_Private</code>.
*
* @param[in] resource A <code>PP_Resource</code> corresponding to a
* <code>PPB_OutputProtection_Private</code>.
*
* @return <code>PP_TRUE</code> if the resource is a
* <code>PPB_OutputProtection_Private</code>, <code>PP_FALSE</code> if the
* resource is invalid or some type other than
* <code>PPB_OutputProtection_Private</code>.
*/
PP_Bool IsOutputProtection([in] PP_Resource resource);
/**
* Query link status and protection status.
* Clients have to query status periodically in order to detect changes.
*
* @param[in] resource A <code>PP_Resource</code> corresponding to a
* <code>PPB_OutputProtection_Private</code>.
* @param[out] link_mask The type of connected output links, which is a
* bit-mask of the <code>PP_OutputProtectionLinkType_Private</code> values.
* @param[out] protection_mask Enabled protection methods, which is a
* bit-mask of the <code>PP_OutputProtectionMethod_Private</code> values.
* @param[in] callback A <code>PP_CompletionCallback</code> to run on
* asynchronous completion of QueryStatus(). This callback will only run if
* QueryStatus() returns <code>PP_OK_COMPLETIONPENDING</code>.
*
* @return An int32_t containing an error code from <code>pp_errors.h</code>.
*/
int32_t QueryStatus(
[in] PP_Resource resource,
[out] uint32_t link_mask,
[out] uint32_t protection_mask,
[in] PP_CompletionCallback callback);
/**
* Set desired protection methods.
*
* When the desired protection method(s) have been applied to all applicable
* output links, the relevant bit(s) of the protection_mask returned by
* QueryStatus() will be set. Otherwise, the relevant bit(s) of
* protection_mask will not be set; there is no separate error code or
* callback.
*
* Protections will be disabled if no longer desired by all instances.
*
* @param[in] resource A <code>PP_Resource</code> corresponding to a
* <code>PPB_OutputProtection_Private</code>.
* @param[in] desired_protection_mask The desired protection methods, which
* is a bit-mask of the <code>PP_OutputProtectionMethod_Private</code>
* values.
* @param[in] callback A <code>PP_CompletionCallback</code> to be called with
* <code>PP_OK</code> when the protection request has been made. This may be
* before the protection have actually been applied. Call QueryStatus to get
* protection status. If it failed to make the protection request, the
* callback is called with <code>PP_ERROR_FAILED</code> and there is no need
* to call QueryStatus().
*
* @return An int32_t containing an error code from <code>pp_errors.h</code>.
*/
int32_t EnableProtection(
[in] PP_Resource resource,
[in] uint32_t desired_protection_mask,
[in] PP_CompletionCallback callback);
};
|
