Add PPAPI decryptor interfaces.

ppapi/c/dev/ppp_content_decryptor_dev.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 dev/ppp_content_decryptor_dev.idl modified Mon Jul 16 17:58:10 2012. */
+
+#ifndef PPAPI_C_DEV_PPP_CONTENT_DECRYPTOR_DEV_H_
+#define PPAPI_C_DEV_PPP_CONTENT_DECRYPTOR_DEV_H_
+
+#include "ppapi/c/pp_bool.h"
+#include "ppapi/c/pp_completion_callback.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_DEV_INTERFACE_0_1 "PPP_ContentDecryptor(Dev);0.1"
+#define PPP_CONTENTDECRYPTOR_DEV_INTERFACE \
+    PPP_CONTENTDECRYPTOR_DEV_INTERFACE_0_1
+
+/**
+ * @file
+ * This file defines the <code>PPP_ContentDecryptor_Dev</code>
+ * interface.
+ */
+
+/**
+ * @addtogroup Interfaces
+ * @{
+ */
+
+/**
+ * <code>PPP_ContentDecryptor_Dev</code> structure contains the function
+ * pointers the decryption plugin MUST implement to provide services needed by
+ * the media stack.
+ */
+struct PPP_ContentDecryptor_Dev_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).
+   */
+  PP_Bool (*GenerateKeyRequest)(PP_Instance instance,
+                                struct PP_Var key_system,  /* String. */
+                                PP_Resource init_data);    /* PPB_Buffer. */
+
+  /**
+   * Provides a key or license to use for decrypting media data for session_id.
+   */
+  PP_Bool (*AddKey)(PP_Instance instance,
+                    struct PP_Var session_id,  /* String. */
+                    PP_Resource key);          /* PPB_Buffer. */
+
+  /**
+   * Cancels a key request for session_id.
+   */
+  PP_Bool (*CancelKeyRequest)(PP_Instance instance,
+                              struct PP_Var session_id);  /* String. */
+
+  /**
+   * Decrypts the block and returns the unencrypted block. In the case of
+   * media, the block contains encoded data.
+   */
+  PP_Bool (*Decrypt)(PP_Instance instance,
+                     PP_Resource encrypted_block,  /* PPB_Buffer. */
+                     struct PP_CompletionCallback callback);
+
+  /**
+   * Decrypts the block then decodes it and returns the unencrypted raw
+   * (decoded) frame.
+   */
+  PP_Bool (*DecryptAndDecode)(PP_Instance instance,
+                              PP_Resource encrypted_block,  /* PPB_Buffer. */
+                              struct PP_CompletionCallback callback);
+};
+
+typedef struct PPP_ContentDecryptor_Dev_0_1 PPP_ContentDecryptor_Dev;
+
+/**
+ * @}
+ */
+
+#endif  /* PPAPI_C_DEV_PPP_CONTENT_DECRYPTOR_DEV_H_ */