Add PPAPI decryptor interfaces.

BUG=138139
TEST=none

Review URL: https://chromiumcodereview.appspot.com/10545036

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@151571 0039d316-1c4b-4281-b951-d872f2087c98

ppapi/api/private/ppb_content_decryptor_private.idl

+/* Copyright (c) 2012 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 <code>PPB_ContentDecryptor_Private</code>
+ * interface. Note: This is a special interface, only to be used for Content
+ * Decryption Modules, not normal plugins.
+ */
+label Chrome {
+  M23 = 0.1
+};
+
+/**
+ * <code>PPB_ContentDecryptor_Private</code> structure contains the function
+ * pointers the browser must implement to support plugins implementing the
+ * <code>PPP_ContentDecryptor_Private</code> interface. This interface provides
+ * browser side support for the Content Decryption Module (CDM) for v0.1 of the
+ * proposed Encrypted Media Extensions: http://goo.gl/rbdnR
+ */
+interface PPB_ContentDecryptor_Private {
+  /**
+   * The decryptor requires a key that has not been provided.
+   *
+   * Sent when the decryptor encounters encrypted content, but it does not have
+   * the key required to decrypt the data. The plugin will call this method in
+   * response to a call to the <code>Decrypt()</code> method on the
+   * <code>PPP_ContentDecryptor_Private<code> interface.
+   *
+   * The browser must notify the application that a key is needed, and, in
+   * response, the web application must direct the browser to call
+   * <code>AddKey()</code> on the <code>PPP_ContentDecryptor_Private<code>
+   * interface.
+   *
+   * @param[in] key_system A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the name of the key system.
+   *
+   * @param[in] session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session ID.
+   *
+   * @param[in] init_data A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_ARRAYBUFFER</code> containing container-specific
+   * initialization data.
+   */
+  void NeedKey(
+      [in] PP_Instance instance,
+      [in] PP_Var key_system,
+      [in] PP_Var session_id,
+      [in] PP_Var init_data);
+
+  /**
+   * A key has been added as the result of a call to the <code>AddKey()</code>
+   * method on the <code>PPP_ContentDecryptor_Private</code> interface.
+   *
+   * Note: The above describes the most simple case. Depending on the key
+   * system, a series of <code>KeyMessage()</code> calls from the CDM will be
+   * sent to the browser, and then on to the web application. The web
+   * application must then provide more data to the CDM by directing the browser
+   * to pass the data to the CDM via calls to <code>AddKey()</code> on the
+   * <code>PPP_ContentDecryptor_Private</code> interface.
+   * The CDM must call <code>KeyAdded()</code> when the sequence is completed,
+   * and, in response, the browser must notify the web application.
+   *
+   * @param[in] key_system A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the name of the key system.
+   *
+   * @param[in] session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session ID.
+   */
+  void KeyAdded(
+      [in] PP_Instance instance,
+      [in] PP_Var key_system,
+      [in] PP_Var session_id);
+
+  /**
+   * A message or request has been generated for key_system in the CDM, and
+   * must be sent to the web application.
+   *
+   * For example, when the browser invokes <code>GenerateKeyRequest()</code>
+   * on the <code>PPP_ContentDecryptor_Private</code> interface, the plugin
+   * must send a key message containing the key request.
+   *
+   * Note that <code>KeyMessage()</code> can be used for purposes other than
+   * responses to <code>GenerateKeyRequest()</code> calls. See also the text
+   * in the comment for <code>KeyAdded()</code>, which describes a sequence of
+   * <code>AddKey()</code> and <code>KeyMessage()</code> calls required to
+   * prepare for decryption.
+   *
+   * @param[in] key_system A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the name of the key system.
+   *
+   * @param[in] session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session ID.
+   *
+   * @param[in] resource A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_Buffer_Dev</code> resource that contains the message.
+   *
+   * @param[in] default_url A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the default URL for the message.
+   */
+  void KeyMessage(
+      [in] PP_Instance instance,
+      [in] PP_Var key_system,
+      [in] PP_Var session_id,
+      [in] PP_Resource message,
+      [in] PP_Var default_url);
+
+  /**
+   * An error occurred in a <code>PPP_ContentDecryptor_Private</code> method,
+   * or within the plugin implementing the interface.
+   *
+   * @param[in] key_system A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the name of the key system.
+   *
+   * @param[in] session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session ID.
+   *
+   * @param[in] media_error A MediaKeyError.
+   *
+   * @param[in] system_error A system error code.
+   */
+  void KeyError(
+      [in] PP_Instance instance,
+      [in] PP_Var key_system,
+      [in] PP_Var session_id,
+      [in] int32_t media_error,
+      [in] int32_t system_code);
+
+  /**
+   * Called after the <code>Decrypt()</code> method on the
+   * <code>PPP_ContentDecryptor_Private</code> interface completes to
+   * deliver decrypted_block to the browser for decoding and rendering.
+   *
+   * @param[in] decrypted_block A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_Buffer_Dev</code> resource that contains a decrypted data
+   * block.
+   *
+   * @param[in] request_id A unique value the browser can use to associate
+   * decrypted_block with a decrypt call.
+   */
+  void DeliverBlock(
+      [in] PP_Instance instance,
+      [in] PP_Resource decrypted_block,
+      [in] int32_t request_id);
+
+  /**
+   * Called after the <code>DecryptAndDecode()</code> method on the
+   * <code>PPP_ContentDecryptor_Private</code> interface completes to deliver
+   * a decrypted and decoded video frame to the browser for rendering.
+   *
+   * @param[in] decrypted_frame A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_Buffer_Dev</code> resource that contains a video frame.
+   *
+   * @param[in] request_id A unique value the browser can use to associate
+   * decrypted_frame with a decrypt call.
+   */
+  void DeliverFrame(
+      [in] PP_Instance instance,
+      [in] PP_Resource decrypted_frame,
+      [in] int32_t request_id);
+
+  /**
+   * Called after the <code>DecryptAndDecode()</code> method on the
+   * <code>PPP_ContentDecryptor_Private</code> interface completes to
+   * deliver a buffer of decrypted and decoded audio samples to the browser for
+   * rendering.
+   *
+   * @param[in] decrypted_samples A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_Buffer_Dev</code> resource that contains a decrypted buffer
+   * of decoded audio samples.
+   *
+   * @param[in] request_id A unique value the browser can use to associate
+   * decrypted_samples with a decrypt call.
+   */
+  void DeliverSamples(
+      [in] PP_Instance instance,
+      [in] PP_Resource decrypted_samples,
+      [in] int32_t request_id);
+};

ppapi/api/private/ppp_content_decryptor_private.idl

+/* Copyright (c) 2012 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 <code>PPP_ContentDecryptor_Private</code>
+ * interface. Note: This is a special interface, only to be used for Content
+ * Decryption Modules, not normal plugins.
+ */
+label Chrome {
+  M23 = 0.1
+};
+
+/**
+ * <code>PPP_ContentDecryptor_Private</code> structure contains the function
+ * pointers the decryption plugin must implement to provide services needed by
+ * the browser. This interface provides the plugin side support for the Content
+ * Decryption Module (CDM) for v0.1 of the proposed Encrypted Media Extensions:
+ * http://goo.gl/rbdnR
+ */
+interface PPP_ContentDecryptor_Private {
+  /**
+   * Generates a key request. key_system specifies the key or licensing system
+   * to use. init_data is a data buffer containing data for use in generating
+   * the request.
+   *
+   * Note: <code>GenerateKeyRequest()</code> must create the session ID used in
+   * other methods on this interface. The session ID must be provided to the
+   * browser by the CDM via <code>KeyMessage()</code> on the
+   * <code>PPB_ContentDecryptor_Private</code> interface.
+   *
+   * @param[in] key_system A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the name of the key system.
+   *
+   * @param[in] init_data A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_ARRAYBUFFER</code> containing container specific
+   * initialization data.
+   */
+  PP_Bool GenerateKeyRequest(
+      [in] PP_Instance instance,
+      [in] PP_Var key_system,
+      [in] PP_Var init_data);
+
+  /**
+   * Provides a key or license to the decryptor for decrypting media data.
+   *
+   * When the CDM needs more information to complete addition of the key it
+   * will call <code>KeyMessage()</code> on the
+   * <code>PPB_ContentDecryptor_Private</code> interface, which the browser
+   * passes to the application. When the key is ready to use, the CDM
+   * must call call <code>KeyAdded()</code> on the
+   * <code>PPB_ContentDecryptor_Private</code> interface, and the browser
+   * must notify the web application.
+   *
+   * @param[in] session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session ID.
+   *
+   * @param[in] key A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_ARRAYBUFFER</code> containing the decryption key, license,
+   * or other message for the given session ID.
+   */
+  PP_Bool AddKey(
+      [in] PP_Instance instance,
+      [in] PP_Var session_id,
+      [in] PP_Var key);
+
+  /**
+   * Cancels a pending key request for the specified session ID.
+   *
+   * @param[in] session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session ID.
+   */
+  PP_Bool CancelKeyRequest(
+      [in] PP_Instance instance,
+      [in] PP_Var session_id);
+
+  /**
+   * Decrypts the block and returns the unencrypted block via
+   * <code>DeliverBlock()</code> on the
+   * <code>PPB_ContentDecryptor_Private</code> interface. The returned block
+   * contains encoded data.
+   *
+   * @param[in] resource A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_Buffer_Dev</code> resource that contains an encrypted data
+   * block.
+   *
+   * @param[in] request_id A value used by the browser to associate data
+   * returned via the <code>PPB_ContentDecryptor_Private</code> interface with
+   * decryption method calls.
+   */
+  PP_Bool Decrypt(
+      [in] PP_Instance instance,
+      [in] PP_Resource encrypted_block,
+      [in] int32_t request_id);
+
+  /**
+   * Decrypts the block, decodes it, and returns the unencrypted uncompressed
+   * (decoded) media to the browser via the
+   * <code>PPB_ContentDecryptor_Private</code> interface.
+   *
+   * Decrypted and decoded video frames are sent to <code>DeliverFrame()</code>,
+   * and decrypted and decoded audio samples are sent to
+   * <code>DeliverSamples()</code>.
+   *
+   * @param[in] resource A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_Buffer_Dev</code> resource that contains an encrypted data
+   * block.
+   *
+   * @param[in] request_id A value used by the browser to associate data
+   * returned via the <code>PPB_ContentDecryptor_Private</code> interface with
+   * decryption method calls.
+   */
+  PP_Bool DecryptAndDecode(
+      [in] PP_Instance instance,
+      [in] PP_Resource encrypted_block,
+      [in] int32_t request_id);
+};

ppapi/c/private/ppb_content_decryptor_private.h

+/* Copyright (c) 2012 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.
+ */
+
+/* From private/ppb_content_decryptor_private.idl,
+ *   modified Tue Aug 14 11:53:03 2012.
+ */
+
+#ifndef PPAPI_C_PRIVATE_PPB_CONTENT_DECRYPTOR_PRIVATE_H_
+#define PPAPI_C_PRIVATE_PPB_CONTENT_DECRYPTOR_PRIVATE_H_
+
+#include "ppapi/c/pp_bool.h"
+#include "ppapi/c/pp_instance.h"
+#include "ppapi/c/pp_macros.h"
+#include "ppapi/c/pp_resource.h"
+#include "ppapi/c/pp_stdint.h"
+#include "ppapi/c/pp_var.h"
+
+#define PPB_CONTENTDECRYPTOR_PRIVATE_INTERFACE_0_1 \
+    "PPB_ContentDecryptor_Private;0.1"
+#define PPB_CONTENTDECRYPTOR_PRIVATE_INTERFACE \
+    PPB_CONTENTDECRYPTOR_PRIVATE_INTERFACE_0_1
+
+/**
+ * @file
+ * This file defines the <code>PPB_ContentDecryptor_Private</code>
+ * interface. Note: This is a special interface, only to be used for Content
+ * Decryption Modules, not normal plugins.
+ */
+
+
+/**
+ * @addtogroup Interfaces
+ * @{
+ */
+/**
+ * <code>PPB_ContentDecryptor_Private</code> structure contains the function
+ * pointers the browser must implement to support plugins implementing the
+ * <code>PPP_ContentDecryptor_Private</code> interface. This interface provides
+ * browser side support for the Content Decryption Module (CDM) for v0.1 of the
+ * proposed Encrypted Media Extensions: http://goo.gl/rbdnR
+ */
+struct PPB_ContentDecryptor_Private_0_1 {
+  /**
+   * The decryptor requires a key that has not been provided.
+   *
+   * Sent when the decryptor encounters encrypted content, but it does not have
+   * the key required to decrypt the data. The plugin will call this method in
+   * response to a call to the <code>Decrypt()</code> method on the
+   * <code>PPP_ContentDecryptor_Private<code> interface.
+   *
+   * The browser must notify the application that a key is needed, and, in
+   * response, the web application must direct the browser to call
+   * <code>AddKey()</code> on the <code>PPP_ContentDecryptor_Private<code>
+   * interface.
+   *
+   * @param[in] key_system A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the name of the key system.
+   *
+   * @param[in] session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session ID.
+   *
+   * @param[in] init_data A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_ARRAYBUFFER</code> containing container-specific
+   * initialization data.
+   */
+  void (*NeedKey)(PP_Instance instance,
+                  struct PP_Var key_system,
+                  struct PP_Var session_id,
+                  struct PP_Var init_data);
+  /**
+   * A key has been added as the result of a call to the <code>AddKey()</code>
+   * method on the <code>PPP_ContentDecryptor_Private</code> interface.
+   *
+   * Note: The above describes the most simple case. Depending on the key
+   * system, a series of <code>KeyMessage()</code> calls from the CDM will be
+   * sent to the browser, and then on to the web application. The web
+   * application must then provide more data to the CDM by directing the browser
+   * to pass the data to the CDM via calls to <code>AddKey()</code> on the
+   * <code>PPP_ContentDecryptor_Private</code> interface.
+   * The CDM must call <code>KeyAdded()</code> when the sequence is completed,
+   * and, in response, the browser must notify the web application.
+   *
+   * @param[in] key_system A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the name of the key system.
+   *
+   * @param[in] session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session ID.
+   */
+  void (*KeyAdded)(PP_Instance instance,
+                   struct PP_Var key_system,
+                   struct PP_Var session_id);
+  /**
+   * A message or request has been generated for key_system in the CDM, and
+   * must be sent to the web application.
+   *
+   * For example, when the browser invokes <code>GenerateKeyRequest()</code>
+   * on the <code>PPP_ContentDecryptor_Private</code> interface, the plugin
+   * must send a key message containing the key request.
+   *
+   * Note that <code>KeyMessage()</code> can be used for purposes other than
+   * responses to <code>GenerateKeyRequest()</code> calls. See also the text
+   * in the comment for <code>KeyAdded()</code>, which describes a sequence of
+   * <code>AddKey()</code> and <code>KeyMessage()</code> calls required to
+   * prepare for decryption.
+   *
+   * @param[in] key_system A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the name of the key system.
+   *
+   * @param[in] session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session ID.
+   *
+   * @param[in] resource A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_Buffer_Dev</code> resource that contains the message.
+   *
+   * @param[in] default_url A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the default URL for the message.
+   */
+  void (*KeyMessage)(PP_Instance instance,
+                     struct PP_Var key_system,
+                     struct PP_Var session_id,
+                     PP_Resource message,
+                     struct PP_Var default_url);
+  /**
+   * An error occurred in a <code>PPP_ContentDecryptor_Private</code> method,
+   * or within the plugin implementing the interface.
+   *
+   * @param[in] key_system A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the name of the key system.
+   *
+   * @param[in] session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session ID.
+   *
+   * @param[in] media_error A MediaKeyError.
+   *
+   * @param[in] system_error A system error code.
+   */
+  void (*KeyError)(PP_Instance instance,
+                   struct PP_Var key_system,
+                   struct PP_Var session_id,
+                   int32_t media_error,
+                   int32_t system_code);
+  /**
+   * Called after the <code>Decrypt()</code> method on the
+   * <code>PPP_ContentDecryptor_Private</code> interface completes to
+   * deliver decrypted_block to the browser for decoding and rendering.
+   *
+   * @param[in] decrypted_block A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_Buffer_Dev</code> resource that contains a decrypted data
+   * block.
+   *
+   * @param[in] request_id A unique value the browser can use to associate
+   * decrypted_block with a decrypt call.
+   */
+  void (*DeliverBlock)(PP_Instance instance,
+                       PP_Resource decrypted_block,
+                       int32_t request_id);
+  /**
+   * Called after the <code>DecryptAndDecode()</code> method on the
+   * <code>PPP_ContentDecryptor_Private</code> interface completes to deliver
+   * a decrypted and decoded video frame to the browser for rendering.
+   *
+   * @param[in] decrypted_frame A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_Buffer_Dev</code> resource that contains a video frame.
+   *
+   * @param[in] request_id A unique value the browser can use to associate
+   * decrypted_frame with a decrypt call.
+   */
+  void (*DeliverFrame)(PP_Instance instance,
+                       PP_Resource decrypted_frame,
+                       int32_t request_id);
+  /**
+   * Called after the <code>DecryptAndDecode()</code> method on the
+   * <code>PPP_ContentDecryptor_Private</code> interface completes to
+   * deliver a buffer of decrypted and decoded audio samples to the browser for
+   * rendering.
+   *
+   * @param[in] decrypted_samples A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_Buffer_Dev</code> resource that contains a decrypted buffer
+   * of decoded audio samples.
+   *
+   * @param[in] request_id A unique value the browser can use to associate
+   * decrypted_samples with a decrypt call.
+   */
+  void (*DeliverSamples)(PP_Instance instance,
+                         PP_Resource decrypted_samples,
+                         int32_t request_id);
+};
+
+typedef struct PPB_ContentDecryptor_Private_0_1 PPB_ContentDecryptor_Private;
+/**
+ * @}
+ */
+
+#endif  /* PPAPI_C_PRIVATE_PPB_CONTENT_DECRYPTOR_PRIVATE_H_ */
+

ppapi/c/private/ppp_content_decryptor_private.h

+/* Copyright (c) 2012 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.
+ */
+
+/* From private/ppp_content_decryptor_private.idl,
+ *   modified Tue Aug 14 11:06:05 2012.
+ */
+
+#ifndef PPAPI_C_PRIVATE_PPP_CONTENT_DECRYPTOR_PRIVATE_H_
+#define PPAPI_C_PRIVATE_PPP_CONTENT_DECRYPTOR_PRIVATE_H_
+
+#include "ppapi/c/pp_bool.h"
+#include "ppapi/c/pp_instance.h"
+#include "ppapi/c/pp_macros.h"
+#include "ppapi/c/pp_resource.h"
+#include "ppapi/c/pp_stdint.h"
+#include "ppapi/c/pp_var.h"
+
+#define PPP_CONTENTDECRYPTOR_PRIVATE_INTERFACE_0_1 \
+    "PPP_ContentDecryptor_Private;0.1"
+#define PPP_CONTENTDECRYPTOR_PRIVATE_INTERFACE \
+    PPP_CONTENTDECRYPTOR_PRIVATE_INTERFACE_0_1
+
+/**
+ * @file
+ * This file defines the <code>PPP_ContentDecryptor_Private</code>
+ * interface. Note: This is a special interface, only to be used for Content
+ * Decryption Modules, not normal plugins.
+ */
+
+
+/**
+ * @addtogroup Interfaces
+ * @{
+ */
+/**
+ * <code>PPP_ContentDecryptor_Private</code> structure contains the function
+ * pointers the decryption plugin must implement to provide services needed by
+ * the browser. This interface provides the plugin side support for the Content
+ * Decryption Module (CDM) for v0.1 of the proposed Encrypted Media Extensions:
+ * http://goo.gl/rbdnR
+ */
+struct PPP_ContentDecryptor_Private_0_1 {
+  /**
+   * Generates a key request. key_system specifies the key or licensing system
+   * to use. init_data is a data buffer containing data for use in generating
+   * the request.
+   *
+   * Note: <code>GenerateKeyRequest()</code> must create the session ID used in
+   * other methods on this interface. The session ID must be provided to the
+   * browser by the CDM via <code>KeyMessage()</code> on the
+   * <code>PPB_ContentDecryptor_Private</code> interface.
+   *
+   * @param[in] key_system A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the name of the key system.
+   *
+   * @param[in] init_data A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_ARRAYBUFFER</code> containing container specific
+   * initialization data.
+   */
+  PP_Bool (*GenerateKeyRequest)(PP_Instance instance,
+                                struct PP_Var key_system,
+                                struct PP_Var init_data);
+  /**
+   * Provides a key or license to the decryptor for decrypting media data.
+   *
+   * When the CDM needs more information to complete addition of the key it
+   * will call <code>KeyMessage()</code> on the
+   * <code>PPB_ContentDecryptor_Private</code> interface, which the browser
+   * passes to the application. When the key is ready to use, the CDM
+   * must call call <code>KeyAdded()</code> on the
+   * <code>PPB_ContentDecryptor_Private</code> interface, and the browser
+   * must notify the web application.
+   *
+   * @param[in] session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session ID.
+   *
+   * @param[in] key A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_ARRAYBUFFER</code> containing the decryption key, license,
+   * or other message for the given session ID.
+   */
+  PP_Bool (*AddKey)(PP_Instance instance,
+                    struct PP_Var session_id,
+                    struct PP_Var key);
+  /**
+   * Cancels a pending key request for the specified session ID.
+   *
+   * @param[in] session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session ID.
+   */
+  PP_Bool (*CancelKeyRequest)(PP_Instance instance, struct PP_Var session_id);
+  /**
+   * Decrypts the block and returns the unencrypted block via
+   * <code>DeliverBlock()</code> on the
+   * <code>PPB_ContentDecryptor_Private</code> interface. The returned block
+   * contains encoded data.
+   *
+   * @param[in] resource A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_Buffer_Dev</code> resource that contains an encrypted data
+   * block.
+   *
+   * @param[in] request_id A value used by the browser to associate data
+   * returned via the <code>PPB_ContentDecryptor_Private</code> interface with
+   * decryption method calls.
+   */
+  PP_Bool (*Decrypt)(PP_Instance instance,
+                     PP_Resource encrypted_block,
+                     int32_t request_id);
+  /**
+   * Decrypts the block, decodes it, and returns the unencrypted uncompressed
+   * (decoded) media to the browser via the
+   * <code>PPB_ContentDecryptor_Private</code> interface.
+   *
+   * Decrypted and decoded video frames are sent to <code>DeliverFrame()</code>,
+   * and decrypted and decoded audio samples are sent to
+   * <code>DeliverSamples()</code>.
+   *
+   * @param[in] resource A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_Buffer_Dev</code> resource that contains an encrypted data
+   * block.
+   *
+   * @param[in] request_id A value used by the browser to associate data
+   * returned via the <code>PPB_ContentDecryptor_Private</code> interface with
+   * decryption method calls.
+   */
+  PP_Bool (*DecryptAndDecode)(PP_Instance instance,
+                              PP_Resource encrypted_block,
+                              int32_t request_id);
+};
+
+typedef struct PPP_ContentDecryptor_Private_0_1 PPP_ContentDecryptor_Private;
+/**
+ * @}
+ */
+
+#endif  /* PPAPI_C_PRIVATE_PPP_CONTENT_DECRYPTOR_PRIVATE_H_ */
+