OLD | NEW |
1 /* Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 /* Copyright (c) 2012 The Chromium Authors. All rights reserved. |
2 * Use of this source code is governed by a BSD-style license that can be | 2 * Use of this source code is governed by a BSD-style license that can be |
3 * found in the LICENSE file. | 3 * found in the LICENSE file. |
4 */ | 4 */ |
5 | 5 |
6 /** | 6 /** |
7 * This file defines the <code>PPP_ContentDecryptor_Private</code> | 7 * This file defines the <code>PPP_ContentDecryptor_Private</code> |
8 * interface. Note: This is a special interface, only to be used for Content | 8 * interface. Note: This is a special interface, only to be used for Content |
9 * Decryption Modules, not normal plugins. | 9 * Decryption Modules, not normal plugins. |
10 */ | 10 */ |
(...skipping 22 matching lines...) Expand all Loading... |
33 /** | 33 /** |
34 * Creates a session. <code>type</code> contains the MIME type of | 34 * Creates a session. <code>type</code> contains the MIME type of |
35 * <code>init_data</code>. <code>init_data</code> is a data buffer | 35 * <code>init_data</code>. <code>init_data</code> is a data buffer |
36 * containing data for use in generating the request. | 36 * containing data for use in generating the request. |
37 * | 37 * |
38 * Note: <code>CreateSession()</code> must create the session ID used in | 38 * Note: <code>CreateSession()</code> must create the session ID used in |
39 * other methods on this interface. The session ID must be provided to the | 39 * other methods on this interface. The session ID must be provided to the |
40 * browser by the CDM via <code>SessionCreated()</code> on the | 40 * browser by the CDM via <code>SessionCreated()</code> on the |
41 * <code>PPB_ContentDecryptor_Private</code> interface. | 41 * <code>PPB_ContentDecryptor_Private</code> interface. |
42 * | 42 * |
43 * @param[in] reference_id A reference for the session for which a session | 43 * @param[in] session_id A reference for the session for which a session |
44 * should be generated. | 44 * should be generated. |
45 * | 45 * |
46 * @param[in] type A <code>PP_Var</code> of type | 46 * @param[in] type A <code>PP_Var</code> of type |
47 * <code>PP_VARTYPE_STRING</code> containing the MIME type for init_data. | 47 * <code>PP_VARTYPE_STRING</code> containing the MIME type for init_data. |
48 * | 48 * |
49 * @param[in] init_data A <code>PP_Var</code> of type | 49 * @param[in] init_data A <code>PP_Var</code> of type |
50 * <code>PP_VARTYPE_ARRAYBUFFER</code> containing container specific | 50 * <code>PP_VARTYPE_ARRAYBUFFER</code> containing container specific |
51 * initialization data. | 51 * initialization data. |
52 */ | 52 */ |
53 void CreateSession( | 53 void CreateSession( |
54 [in] PP_Instance instance, | 54 [in] PP_Instance instance, |
55 [in] uint32_t reference_id, | 55 [in] uint32_t session_id, |
56 [in] PP_Var type, | 56 [in] PP_Var type, |
57 [in] PP_Var init_data); | 57 [in] PP_Var init_data); |
58 | 58 |
59 /** | 59 /** |
60 * Provides a license or other message to the decryptor. | 60 * Provides a license or other message to the decryptor. |
61 * | 61 * |
62 * When the CDM needs more information, it must call | 62 * When the CDM needs more information, it must call |
63 * <code>SessionMessage()</code> on the | 63 * <code>SessionMessage()</code> on the |
64 * <code>PPB_ContentDecryptor_Private</code> interface, and the browser | 64 * <code>PPB_ContentDecryptor_Private</code> interface, and the browser |
65 * must notify the web application. When the CDM has finished processing | 65 * must notify the web application. When the CDM has finished processing |
66 * <code>response</code> and needs no more information, it must call | 66 * <code>response</code> and needs no more information, it must call |
67 * <code>SessionReady()</code> on the | 67 * <code>SessionReady()</code> on the |
68 * <code>PPB_ContentDecryptor_Private</code> interface, and the browser | 68 * <code>PPB_ContentDecryptor_Private</code> interface, and the browser |
69 * must notify the web application. | 69 * must notify the web application. |
70 * | 70 * |
71 * @param[in] reference_id A reference for the session to update. | 71 * @param[in] session_id A reference for the session to update. |
72 * | 72 * |
73 * @param[in] response A <code>PP_Var</code> of type | 73 * @param[in] response A <code>PP_Var</code> of type |
74 * <code>PP_VARTYPE_ARRAYBUFFER</code> containing the license or other | 74 * <code>PP_VARTYPE_ARRAYBUFFER</code> containing the license or other |
75 * message for the given session ID. | 75 * message for the given session ID. |
76 */ | 76 */ |
77 void UpdateSession( | 77 void UpdateSession( |
78 [in] PP_Instance instance, | 78 [in] PP_Instance instance, |
79 [in] uint32_t reference_id, | 79 [in] uint32_t session_id, |
80 [in] PP_Var response); | 80 [in] PP_Var response); |
81 | 81 |
82 /** | 82 /** |
83 * Release the specified session and related resources. | 83 * Release the specified session and related resources. |
84 * | 84 * |
85 * @param[in] reference_id A reference for the session that should be | 85 * @param[in] session_id A reference for the session that should be |
86 * released. | 86 * released. |
87 */ | 87 */ |
88 void ReleaseSession( | 88 void ReleaseSession( |
89 [in] PP_Instance instance, | 89 [in] PP_Instance instance, |
90 [in] uint32_t reference_id); | 90 [in] uint32_t session_id); |
91 | 91 |
92 /** | 92 /** |
93 * Decrypts the block and returns the unencrypted block via | 93 * Decrypts the block and returns the unencrypted block via |
94 * <code>DeliverBlock()</code> on the | 94 * <code>DeliverBlock()</code> on the |
95 * <code>PPB_ContentDecryptor_Private</code> interface. The returned block | 95 * <code>PPB_ContentDecryptor_Private</code> interface. The returned block |
96 * contains encoded data. | 96 * contains encoded data. |
97 * | 97 * |
98 * @param[in] resource A <code>PP_Resource</code> corresponding to a | 98 * @param[in] resource A <code>PP_Resource</code> corresponding to a |
99 * <code>PPB_Buffer_Dev</code> resource that contains an encrypted data | 99 * <code>PPB_Buffer_Dev</code> resource that contains an encrypted data |
100 * block. | 100 * block. |
(...skipping 113 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
214 * @param[in] encrypted_block_info A <code>PP_EncryptedBlockInfo</code> that | 214 * @param[in] encrypted_block_info A <code>PP_EncryptedBlockInfo</code> that |
215 * contains all auxiliary information needed for decryption of the | 215 * contains all auxiliary information needed for decryption of the |
216 * <code>encrypted_block</code>. | 216 * <code>encrypted_block</code>. |
217 */ | 217 */ |
218 void DecryptAndDecode( | 218 void DecryptAndDecode( |
219 [in] PP_Instance instance, | 219 [in] PP_Instance instance, |
220 [in] PP_DecryptorStreamType decoder_type, | 220 [in] PP_DecryptorStreamType decoder_type, |
221 [in] PP_Resource encrypted_buffer, | 221 [in] PP_Resource encrypted_buffer, |
222 [in] PP_EncryptedBlockInfo encrypted_block_info); | 222 [in] PP_EncryptedBlockInfo encrypted_block_info); |
223 }; | 223 }; |
OLD | NEW |