Add PPAPI decryptor interfaces.

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 Fri Aug 10 07:56:58 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.
+ */
+
+
+/**
+ * @addtogroup Interfaces
+ * @{
+ */
+/**
+ * <code>PPP_ContentDecryptor_Private</code> structure contains the function
+ * pointers the decryption plugin MUST implement to provide services needed by
+ * the media stack. This interface provides the plugin side support for v0.1 of
+ * the proposed Encrypted Media Extensions: http://goo.gl/rbdnR
+ *
+ * Note: This is a special interface, only to be used for Content Decryption
+ * Modules, not normal plugins.
+ */
+struct PPP_ContentDecryptor_Private_0_1 {
+  /**
+   * Generates a key request. key_system specifies the key or licensing system
+   * from which to request the key when the plugin provides access to multiple
+   * systems. init_data is a data buffer containing initialization data from
+   * the media data that is required for use of the plugin's key system(s).
+   *
+   * Note: <code>GenerateKeyRequest()</code> is responsible for creating the
+   * session ID used in other methods on this interface. The session ID will be
+   * provided to the user agent 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 content 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 in the
+   * stream associated with session_id.
+   *
+   * @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 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 user agent 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,
+                     uint64_t request_id);
+  /**
+   * Decrypts the block, decodes it, and returns the unencrypted raw (decoded)
+   * media to the user agent via the <code>PPB_ContentDecryptor_Private</code>
+   * interface.
+   *
+   * @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 user agent 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,
+                              uint64_t request_id);
+};
+
+typedef struct PPP_ContentDecryptor_Private_0_1 PPP_ContentDecryptor_Private;
+/**
+ * @}
+ */
+
+#endif  /* PPAPI_C_PRIVATE_PPP_CONTENT_DECRYPTOR_PRIVATE_H_ */
+