Add PPAPI decryptor interfaces.

ppapi/c/dev/ppb_content_decryption_module_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/ppb_content_decryption_module_dev.idl,
+ *   modified Fri Jun 15 08:41:00 2012.
+ */
+
+#ifndef PPAPI_C_DEV_PPB_CONTENT_DECRYPTION_MODULE_DEV_H_
+#define PPAPI_C_DEV_PPB_CONTENT_DECRYPTION_MODULE_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 PPB_CONTENTDECRYPTIONMODULE_DEV_INTERFACE_0_1 \
+    "PPB_ContentDecryptionModule(Dev);0.1"
+#define PPB_CONTENTDECRYPTIONMODULE_DEV_INTERFACE \
+    PPB_CONTENTDECRYPTIONMODULE_DEV_INTERFACE_0_1
+
+/**
+ * @file
+ * This file defines the <code>PPP_ContentDecryptionModule_Dev</code>
+ * interface.
+ */
+
+/**
+ * @addtogroup Interfaces
+ * @{
+ */
+
+/**
+ * <code>PPB_ContentDecryptionModule_Dev</code> structure contains the function
+ * pointers the browser may implement to support plugins implementing the
+ * <code>PPP_ContentDecryptionModule_Dev</code> interface.
+ */
+struct PPB_ContentDecryptionModule_Dev_0_1 {
+  /**
+   * A key or license is needed to decrypt media data.
+   */
+  void (*NeedKey)(PP_Instance instance,
+                  struct PP_Var key_system,
+                  struct PP_Var session_id,
+                  PP_Resource init_data);
+
+  /**
+   * A key has been added as the result of a call to the <code>AddKey()</code>
+   * method on the <code>PPP_ContentDecryptionModule_Dev</code> interface.
+   */
+  void (*KeyAdded)(PP_Instance instance,
+                   struct PP_Var key_system,
+                   struct PP_Var session_id);
+
+  /**
+   * A message or request has been generated by or for key_system. For example,
+   * a key request has been generated as the result of call to the
+   * <code>GenerateKeyRequest()</code> method on the
+   * <code>PPP_ContentDecryptionModule_Dev</code> interface, or another message
+   * must be sent in response to an <code>AddKey()</code> call.
+   */
+  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 occured in a <code>PPP_ContentDecryptionModule_Dev</code> method,
+   * or within the plugin implementing the interface.
+   */
+  void (*KeyError)(PP_Instance instance,
+                   struct PP_Var key_system,
+                   struct PP_Var session_id,
+                   uint16_t media_error,
+                   uint16_t system_error);
+
+  /**
+   * Called after the <code>Decrypt</code> method on the
+   * <code>PPP_ContentDecryptionModule_Dev</code> interface completes to
+   * deliver decrypted_block to the media stack.
+   */
+  void (*DeliverBlock)(PP_Instance instance,
+                       PP_Resource decrypted_block,
+                       struct PP_CompletionCallback callback);
+
+  /**
+   * Called after the <code>DecryptAndDecode</code> method on the
+   * <code>PPP_ContentDecryptionModule_Dev</code> interface completes to
+   * deliver decrypted_frame to the media stack.
+   */
+  void (*DeliverFrame)(PP_Instance instance,
+                       PP_Resource decrypted_frame,
+                       struct PP_CompletionCallback callback);
+
+  /**
+   * Called after the <code>DecryptAndDecode</code> method on the
+   * <code>PPP_ContentDecryptionModule_Dev</code> interface completes to
+   * deliver decrypted_samples to the media stack.
+   */
+  void (*DeliverSamples)(PP_Instance instance,

[xhwang, 2012/06/18 20:20:41]

I am a little confused about the difference between "frame" and "samples". Also
why sample is in plural but frame is in singular?

[Tom Finegan, 2012/06/18 20:36:58]

I do this out of habit, but I also thinks it makes the interface easier to grok
at first glance.

When an interface has methods that deal with audio and video separately I tend
to name the video methods DoSomethingWithFrame(), and the audio methods 
DoSomethingWithSamples(). The former because most video related code I've
written deals with single frames, and the latter because when dealing with audio
buffers they generally consist of many samples.

I would be fine with having DeliverBlock() and a generalized
DeliverSampleBuffer() that handles audio and video. This is still in RFC state
as far as I'm concerned. Would everyone prefer a single method?

+                         PP_Resource decrypted_samples,
+                         struct PP_CompletionCallback callback);
+};
+
+
+typedef struct PPB_ContentDecryptionModule_Dev_0_1
+    PPB_ContentDecryptionModule_Dev;
+
+/**
+ * @}
+ */
+
+#endif  /* PPAPI_C_DEV_PPB_CONTENT_DECRYPTION_MODULE_DEV_H_ */