Implement device enumeration for PPB_VideoCapture_Dev.

ppapi/c/dev/ppb_video_capture_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_video_capture_dev.idl modified Tue Oct 11 10:01:39 2011. */
+/* From dev/ppb_video_capture_dev.idl modified Thu Jan 26 11:39:48 2012. */
 
 #ifndef PPAPI_C_DEV_PPB_VIDEO_CAPTURE_DEV_H_
 #define PPAPI_C_DEV_PPB_VIDEO_CAPTURE_DEV_H_
 
 #include "ppapi/c/dev/pp_video_capture_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"
 
 #define PPB_VIDEOCAPTURE_DEV_INTERFACE_0_1 "PPB_VideoCapture(Dev);0.1"
-#define PPB_VIDEOCAPTURE_DEV_INTERFACE PPB_VIDEOCAPTURE_DEV_INTERFACE_0_1
+#define PPB_VIDEOCAPTURE_DEV_INTERFACE_0_2 "PPB_VideoCapture(Dev);0.2"
+#define PPB_VIDEOCAPTURE_DEV_INTERFACE PPB_VIDEOCAPTURE_DEV_INTERFACE_0_2
 
 /**
  * @file
  * This file defines the <code>PPB_VideoCapture_Dev</code> interface.
  */
 
 
 /**
  * @addtogroup Interfaces
  * @{
@@ skipping 16 matching lines @@
  * 5- When the plugin is done with the buffer, call ReuseBuffer
  * 6- Stop the capture using StopCapture.
  *
  * The browser may change the resolution based on the constraints of the system,
  * in which case OnDeviceInfo will be called again, with new buffers.
  *
  * The buffers contain the pixel data for a frame. The format is planar YUV
  * 4:2:0, one byte per pixel, tightly packed (width x height Y values, then
  * width/2 x height/2 U values, then width/2 x height/2 V values).
  */
-struct PPB_VideoCapture_Dev_0_1 {
+struct PPB_VideoCapture_Dev_0_2 {
   /**
    * Creates a new VideoCapture.
    */
   PP_Resource (*Create)(PP_Instance instance);
   /**
    * Returns PP_TRUE if the given resource is a VideoCapture.
    */
   PP_Bool (*IsVideoCapture)(PP_Resource video_capture);
   /**
-   * Starts the capture. |requested_info| is a pointer to a structure containing
-   * the requested resolution and frame rate. |buffer_count| is the number of
-   * buffers requested by the plugin. Note: it is only used as advisory, the
-   * browser may allocate more of fewer based on available resources.
-   * How many buffers depends on usage. At least 2 to make sure latency doesn't
-   * cause lost frames. If the plugin expects to hold on to more than one buffer
-   * at a time (e.g. to do multi-frame processing, like video encoding), it
-   * should request that many more.
+   * Enumerates video capture devices. Once the operation is completed
+   * successfully. |GetDevices()| can be used to retrieve the devices.
+   */
+  int32_t (*EnumerateDevices)(PP_Resource video_capture,
+                              struct PP_CompletionCallback callback);
+  /**
+   * Gets video capture devices. The returned value is a PPB_ResourceArray_Dev
+   * resource if successful, which holds a list of PPB_DeviceRef_Dev resources.
+   */
+  PP_Resource (*GetDevices)(PP_Resource video_capture);
+  /**
+   * Starts the capture. |device_ref| identifies a video capture device. It
+   * could be one of the resource in the array returned by |GetDevices()|, or 0
+   * which means the default device.
+   * |requested_info| is a pointer to a structure containing the requested
+   * resolution and frame rate. |buffer_count| is the number of buffers
+   * requested by the plugin. Note: it is only used as advisory, the browser may
+   * allocate more or fewer based on available resources. How many buffers
+   * depends on usage. At least 2 to make sure latency doesn't cause lost
+   * frames. If the plugin expects to hold on to more than one buffer at a time
+   * (e.g. to do multi-frame processing, like video encoding), it should request
+   * that many more.
    *
    * Returns PP_ERROR_FAILED if called when the capture was already started, or
    * PP_OK on success.
    */
   int32_t (*StartCapture)(
       PP_Resource video_capture,
+      PP_Resource device_ref,
       const struct PP_VideoCaptureDeviceInfo_Dev* requested_info,
       uint32_t buffer_count);
   /**
    * Allows the browser to reuse a buffer that was previously sent by
    * PPP_VideoCapture_Dev.OnBufferReady. |buffer| is the index of the buffer in
    * the array returned by PPP_VideoCapture_Dev.OnDeviceInfo.
    *
    * Returns PP_ERROR_BADARGUMENT if buffer is out of range (greater than the
    * number of buffers returned by PPP_VideoCapture_Dev.OnDeviceInfo), or if it
    * is not currently owned by the plugin. Returns PP_OK otherwise.
    */
   int32_t (*ReuseBuffer)(PP_Resource video_capture, uint32_t buffer);
   /**
    * Stops the capture.
    *
    * Returns PP_ERROR_FAILED if the capture wasn't already started, or PP_OK on
    * success.
    */
   int32_t (*StopCapture)(PP_Resource video_capture);
 };
 
-typedef struct PPB_VideoCapture_Dev_0_1 PPB_VideoCapture_Dev;
+typedef struct PPB_VideoCapture_Dev_0_2 PPB_VideoCapture_Dev;
+
+struct PPB_VideoCapture_Dev_0_1 {
+  PP_Resource (*Create)(PP_Instance instance);
+  PP_Bool (*IsVideoCapture)(PP_Resource video_capture);
+  int32_t (*StartCapture)(
+      PP_Resource video_capture,
+      const struct PP_VideoCaptureDeviceInfo_Dev* requested_info,
+      uint32_t buffer_count);
+  int32_t (*ReuseBuffer)(PP_Resource video_capture, uint32_t buffer);
+  int32_t (*StopCapture)(PP_Resource video_capture);
+};
 /**
  * @}
  */
 
 #endif  /* PPAPI_C_DEV_PPB_VIDEO_CAPTURE_DEV_H_ */