Add Promises for EME (Chromium side)

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 Wed Feb 26 16:37:47 2014.
+ *   modified Thu Jun  5 13:39:15 2014.
  */
 
 #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"
 #include "ppapi/c/private/pp_content_decryptor.h"
 
-#define PPB_CONTENTDECRYPTOR_PRIVATE_INTERFACE_0_11 \
-    "PPB_ContentDecryptor_Private;0.11"
+#define PPB_CONTENTDECRYPTOR_PRIVATE_INTERFACE_0_12 \
+    "PPB_ContentDecryptor_Private;0.12"
 #define PPB_CONTENTDECRYPTOR_PRIVATE_INTERFACE \
-    PPB_CONTENTDECRYPTOR_PRIVATE_INTERFACE_0_11
+    PPB_CONTENTDECRYPTOR_PRIVATE_INTERFACE_0_12
 
 /**
  * @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 Encrypted
  * Media Extensions: http://www.w3.org/TR/encrypted-media/
  */
-struct PPB_ContentDecryptor_Private_0_11 {
+struct PPB_ContentDecryptor_Private_0_12 {
   /**
-   * A session has been created by the CDM.
+   * A promise has been resolved by the CDM.
    *
-   * @param[in] session_id Identifies the session for which the CDM
-   * created a session.
+   * @param[in] promise_id Identifies the promise that the CDM resolved.
+   */
+  void (*PromiseResolved)(PP_Instance instance, uint32_t promise_id);
+  /**
+   * A promise has been resolved by the CDM.
+   *
+   * @param[in] promise_id Identifies the promise that the CDM resolved.
    *
    * @param[in] web_session_id A <code>PP_Var</code> of type
-   * <code>PP_VARTYPE_STRING</code> containing the string for the
-   * MediaKeySession's sessionId attribute.
+   * <code>PP_VARTYPE_STRING</code> containing the session's ID attribute.
+   */
+  void (*PromiseResolvedWithSession)(PP_Instance instance,
+                                     uint32_t promise_id,
+                                     struct PP_Var web_session_id);
+  /**
+   * A promise has been rejected by the CDM due to an error.
    *
+   * @param[in] promise_id Identifies the promise that the CDM rejected.
+   *
+   * @param[in] exception_code A <code>PP_CdmExceptionCode</code> containing
+   * the exception code.
+   *
+   * @param[in] system_code A system error code.
+   *
+   * @param[in] error_description A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the error description.
    */
-  void (*SessionCreated)(PP_Instance instance,
-                         uint32_t session_id,
-                         struct PP_Var web_session_id);
+  void (*PromiseRejected)(PP_Instance instance,
+                          uint32_t promise_id,
+                          PP_CdmExceptionCode exception_code,
+                          uint32_t system_code,
+                          struct PP_Var error_description);
   /**
    * 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>CreateSession()</code>
    * on the <code>PPP_ContentDecryptor_Private</code> interface, the plugin
    * must send a message containing the license request.
    *
    * Note that <code>SessionMessage()</code> can be used for purposes other than
    * responses to <code>CreateSession()</code> calls. See also the text
    * in the comment for <code>SessionReady()</code>, which describes a sequence
    * of <code>UpdateSession()</code> and <code>SessionMessage()</code> calls
    * required to prepare for decryption.
    *
-   * @param[in] session_id Identifies the session for which the message
-   * is intended.
+   * @param[in] web_session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session's ID attribute for
+   * which the message is intended.
    *
    * @param[in] message A <code>PP_Var</code> of type
    * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the message.
    *
    * @param[in] destination_url A <code>PP_Var</code> of type
    * <code>PP_VARTYPE_STRING</code> containing the destination URL for the
    * message.
    */
   void (*SessionMessage)(PP_Instance instance,
-                         uint32_t session_id,
+                         struct PP_Var web_session_id,
                          struct PP_Var message,
                          struct PP_Var destination_url);
   /**
    * The session is now ready to decrypt the media stream.
    *
    * Note: The above describes the most simple case. Depending on the key
    * system, a series of <code>SessionMessage()</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>UpdateSession()</code> on
    * the <code>PPP_ContentDecryptor_Private</code> interface.
    * The CDM must call <code>SessionReady()</code> when the sequence is
    * completed, and, in response, the browser must notify the web application.
    *
-   * @param[in] session_id Identifies the session that is ready.
+   * @param[in] web_session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session's ID attribute of
+   * the session that is now ready.
    */
-  void (*SessionReady)(PP_Instance instance, uint32_t session_id);
+  void (*SessionReady)(PP_Instance instance, struct PP_Var web_session_id);
   /**
    * The session has been closed as the result of a call to the
    * <code>ReleaseSession()</code> method on the
    * <code>PPP_ContentDecryptor_Private</code> interface, or due to other
    * factors as determined by the CDM.
    *
-   * @param[in] session_id Identifies the session that is closed.
+   * @param[in] web_session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session's ID attribute of
+   * the session that is now closed.
    */
-  void (*SessionClosed)(PP_Instance instance, uint32_t session_id);
+  void (*SessionClosed)(PP_Instance instance, struct PP_Var web_session_id);
   /**
    * An error occurred in a <code>PPP_ContentDecryptor_Private</code> method,
    * or within the plugin implementing the interface.
    *
-   * @param[in] session_id Identifies the session for which the error
-   * is intended.
+   * @param[in] web_session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session's ID attribute of
+   * the session that caused the error.
    *
-   * @param[in] media_error A MediaKeyError.
+   * @param[in] exception_code A <code>PP_CdmExceptionCode</code> containing
+   * the exception code.
    *
-   * @param[in] system_error A system error code.
+   * @param[in] system_code A system error code.
+   *
+   * @param[in] error_description A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the error description.
    */
   void (*SessionError)(PP_Instance instance,
-                       uint32_t session_id,
-                       int32_t media_error,
-                       uint32_t system_code);
+                       struct PP_Var web_session_id,
+                       PP_CdmExceptionCode exception_code,
+                       uint32_t system_code,
+                       struct PP_Var error_description);
   /**
    * 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.
    *
    * The plugin must not hold a reference to the encrypted buffer resource
    * provided to <code>Decrypt()</code> when it calls this method. The browser
    * will reuse the buffer in a subsequent <code>Decrypt()</code> call.
    *
    * @param[in] decrypted_block A <code>PP_Resource</code> corresponding to a
@@ skipping 109 matching lines @@
    * @param[in] decrypted_sample_info A <code>PP_DecryptedSampleInfo</code> that
    * contains the tracking info and result code associated with the decrypted
    * samples.
    */
   void (*DeliverSamples)(
       PP_Instance instance,
       PP_Resource audio_frames,
       const struct PP_DecryptedSampleInfo* decrypted_sample_info);
 };
 
-typedef struct PPB_ContentDecryptor_Private_0_11 PPB_ContentDecryptor_Private;
+typedef struct PPB_ContentDecryptor_Private_0_12 PPB_ContentDecryptor_Private;
 /**
  * @}
  */
 
 #endif  /* PPAPI_C_PRIVATE_PPB_CONTENT_DECRYPTOR_PRIVATE_H_ */