Implement device enumeration for PPB_VideoCapture_Dev.

webkit/plugins/ppapi/plugin_delegate.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.
 
 #ifndef WEBKIT_PLUGINS_PPAPI_PLUGIN_DELEGATE_H_
 #define WEBKIT_PLUGINS_PPAPI_PLUGIN_DELEGATE_H_
 
 #include <string>
+#include <vector>
 
 #include "base/callback.h"
 #include "base/message_loop_proxy.h"
 #include "base/memory/ref_counted.h"
 #include "base/platform_file.h"
 #include "base/shared_memory.h"
 #include "base/sync_socket.h"
 #include "base/time.h"
 #include "googleurl/src/gurl.h"
 #include "media/video/capture/video_capture.h"
 #include "media/video/video_decode_accelerator.h"
 #include "ppapi/c/dev/pp_video_dev.h"
+#include "ppapi/c/dev/ppb_device_ref_dev.h"
 #include "ppapi/c/pp_completion_callback.h"
 #include "ppapi/c/pp_errors.h"
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_stdint.h"
 #include "ui/gfx/size.h"
 #include "webkit/fileapi/file_system_types.h"
 #include "webkit/plugins/ppapi/dir_contents.h"
 #include "webkit/quota/quota_types.h"
 
 class GURL;
@@ skipping 12 matching lines @@
 
 namespace gfx {
 class Point;
 }
 
 namespace gpu {
 class CommandBuffer;
 }
 
 namespace ppapi {
+struct DeviceRefData;
 struct Preferences;
 }
 
 namespace skia {
 class PlatformCanvas;
 }
 
 namespace WebKit {
 class WebFileChooserCompletion;
 class WebGamepads;
@@ skipping 169 matching lines @@
     virtual ~PlatformAudioInput() {}
   };
 
   // Interface for PlatformVideoDecoder is directly inherited from general media
   // VideoDecodeAccelerator interface.
   class PlatformVideoDecoder : public media::VideoDecodeAccelerator {
    protected:
     virtual ~PlatformVideoDecoder() {}
   };
 
-  class PlatformVideoCapture : public media::VideoCapture {
+  class PlatformVideoCaptureEventHandler
+      : public media::VideoCapture::EventHandler {
+   public:
+    virtual ~PlatformVideoCaptureEventHandler() {}
+
+    virtual void OnInitialized(media::VideoCapture* capture,
+                               bool succeeded) = 0;
+  };
+
+  class PlatformVideoCapture : public media::VideoCapture,
+                               public base::RefCounted<PlatformVideoCapture> {
    public:
     virtual ~PlatformVideoCapture() {}
+
+    // Detaches the event handler and stops sending notifications to it.
+    virtual void DetachEventHandler() = 0;
   };
 
   // Provides access to the ppapi broker.
   class PpapiBroker {
    public:
     virtual void Connect(webkit::ppapi::PPB_Broker_Impl* client) = 0;
 
     // Decrements the references to the broker.
     // When there are no more references, this renderer's dispatcher is
     // destroyed, allowing the broker to shutdown if appropriate.
@@ skipping 33 matching lines @@
   // Returns a pointer (ownership not transferred) to the bitmap to paint the
   // sad plugin screen with. Returns NULL on failure.
   virtual SkBitmap* GetSadPluginBitmap() = 0;
 
   // The caller will own the pointer returned from this.
   virtual PlatformImage2D* CreateImage2D(int width, int height) = 0;
 
   // The caller will own the pointer returned from this.
   virtual PlatformContext3D* CreateContext3D() = 0;
 
-  // The caller will own the pointer returned from this.
+  // If |device_id| is empty, the default video capture device will be used. The
+  // user can start using the returned object to capture video right away.
+  // Otherwise, the specified device will be used. The user needs to wait till
+  // |handler| gets an OnInitialized() notification to start using the returned
+  // object.
   virtual PlatformVideoCapture* CreateVideoCapture(
-      media::VideoCapture::EventHandler* handler) = 0;
+      const std::string& device_id,
+      PlatformVideoCaptureEventHandler* handler) = 0;
 
   // The caller will own the pointer returned from this.
   virtual PlatformVideoDecoder* CreateVideoDecoder(
       media::VideoDecodeAccelerator::Client* client,
       int32 command_buffer_route_id) = 0;
 
   // The caller is responsible for calling Shutdown() on the returned pointer
   // to clean up the corresponding resources allocated during this call.
   virtual PlatformAudio* CreateAudio(uint32_t sample_rate,
                                      uint32_t sample_count,
@@ skipping 206 matching lines @@
   virtual void DidReceiveMouseEvent(PluginInstance* instance) = 0;
 
   // Determines if the browser entered fullscreen mode.
   virtual bool IsInFullscreenMode() = 0;
 
   // Retrieve current gamepad data.
   virtual void SampleGamepads(WebKit::WebGamepads* data) = 0;
 
   // Returns true if the containing page is visible.
   virtual bool IsPageVisible() const = 0;
+
+  typedef base::Callback<
+      void (int /* request_id */,
+            bool /* succeeded */,
+            const std::vector< ::ppapi::DeviceRefData>& /* devices */)>
+      EnumerateDevicesCallback;
+
+  // Enumerates devices of the specified type. The request ID passed into the
+  // callback will be the same as the return value.
+  virtual int EnumerateDevices(PP_DeviceType_Dev type,
+                               const EnumerateDevicesCallback& callback) = 0;
 };
 
 }  // namespace ppapi
 }  // namespace webkit
 
 #endif  // WEBKIT_PLUGINS_PPAPI_PLUGIN_DELEGATE_H_