Begin adding support for tab mirroring via the MediaStream audio/video capturing

content/browser/renderer_host/media/video_capture_manager.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.
 
 // VideoCaptureManager is used to open/close, start/stop, enumerate available
 // video capture devices, and manage VideoCaptureController's.
 // All functions are expected to be called from Browser::IO thread.
 // VideoCaptureManager will open OS dependent instances of VideoCaptureDevice.
 // A device can only be opened once.
 
@@ skipping 11 matching lines @@
 #include "media/video/capture/video_capture_device.h"
 #include "media/video/capture/video_capture_types.h"
 
 class MockVideoCaptureManager;
 class VideoCaptureController;
 class VideoCaptureControllerEventHandler;
 
 namespace media_stream {
 
 // VideoCaptureManager opens/closes and start/stops video capture devices.
-class CONTENT_EXPORT VideoCaptureManager
-    : public base::RefCountedThreadSafe<VideoCaptureManager>,
-      public MediaStreamProvider {
+class CONTENT_EXPORT VideoCaptureManager : public MediaStreamProvider {
  public:
   // Calling |Start| of this id will open the first device, even though open has
   // not been called. This is used to be able to use video capture devices
   // before MediaStream is implemented in Chrome and WebKit.
   enum { kStartOpenSessionId = 1 };
 
   VideoCaptureManager();
 
   // Implements MediaStreamProvider.
   virtual void Register(MediaStreamProviderListener* listener,
@@ skipping 35 matching lines @@
       const media::VideoCaptureParams& capture_params,
       VideoCaptureControllerEventHandler* handler,
       base::Callback<void(VideoCaptureController*)> added_cb);
   // Called by VideoCaptureHost to remove the |controller|.
   void RemoveController(
       VideoCaptureController* controller,
       VideoCaptureControllerEventHandler* handler);
 
  private:
   friend class ::MockVideoCaptureManager;
-  friend class base::RefCountedThreadSafe<VideoCaptureManager>;
 
   virtual ~VideoCaptureManager();
 
   typedef std::list<VideoCaptureControllerEventHandler*> Handlers;
   struct Controller;
 
   // Called by the public functions, executed on device thread.
   void OnEnumerateDevices();
   void OnOpen(int capture_session_id, const StreamDeviceInfo& device);
   void OnClose(int capture_session_id);
   void OnStart(const media::VideoCaptureParams capture_params,
                media::VideoCaptureDevice::EventHandler* video_capture_receiver);
   void OnStop(const media::VideoCaptureSessionId capture_session_id,
               base::Closure stopped_cb);
   void DoAddControllerOnDeviceThread(
       const media::VideoCaptureParams capture_params,
       VideoCaptureControllerEventHandler* handler,
       base::Callback<void(VideoCaptureController*)> added_cb);
   void DoRemoveControllerOnDeviceThread(
       VideoCaptureController* controller,
       VideoCaptureControllerEventHandler* handler);
 
   // Executed on Browser::IO thread to call Listener.
-  void OnOpened(int capture_session_id);
-  void OnClosed(int capture_session_id);
+  void OnOpened(content::MediaStreamDeviceType type, int capture_session_id);
+  void OnClosed(content::MediaStreamDeviceType type, int capture_session_id);
   void OnDevicesEnumerated(const StreamDeviceInfoArray& devices);
-  void OnError(int capture_session_id, MediaStreamProviderError error);
+  void OnError(content::MediaStreamDeviceType type, int capture_session_id,
+               MediaStreamProviderError error);
 
   // Executed on device thread to make sure Listener is called from
   // Browser::IO thread.
-  void PostOnOpened(int capture_session_id);
-  void PostOnClosed(int capture_session_id);
+  void PostOnOpened(content::MediaStreamDeviceType type,
+                    int capture_session_id);
+  void PostOnClosed(content::MediaStreamDeviceType type,
+                    int capture_session_id);
   void PostOnDevicesEnumerated(const StreamDeviceInfoArray& devices);
   void PostOnError(int capture_session_id, MediaStreamProviderError error);
 
   // Helpers
   void GetAvailableDevices(media::VideoCaptureDevice::Names* device_names);
   bool DeviceOpened(const media::VideoCaptureDevice::Name& device_name);
   bool DeviceInUse(const media::VideoCaptureDevice* video_capture_device);
   media::VideoCaptureDevice* GetOpenedDevice(
       const StreamDeviceInfo& device_info);
   bool IsOnDeviceThread() const;
   media::VideoCaptureDevice* GetDeviceInternal(int capture_session_id);
 
   // The message loop of media stream device thread that this object runs on.
   scoped_refptr<base::MessageLoopProxy> device_loop_;
 
   // Only accessed on Browser::IO thread.
   MediaStreamProviderListener* listener_;
   int new_capture_session_id_;
 
   // Only accessed from device thread.
   // VideoCaptureManager owns all VideoCaptureDevices and is responsible for
   // deleting the instances when they are not used any longer.
-  typedef std::map<int, media::VideoCaptureDevice*> VideoCaptureDevices;
+  struct DeviceEntry {
+    content::MediaStreamDeviceType stream_type;
+    media::VideoCaptureDevice* capture_device;

[tommi (sloooow) - chröme, 2012/09/10 09:17:25]

who owns the capture_device?
If ownership lies with this class, use scoped_ptr.
Otherwise document ownership and the object lifetimes.

[wjia(left Chromium), 2012/09/10 17:40:16]

The comment above the struct is correct. scoped_ptr can't be used since
VideoCaptureDevice can be shared between capture sessions. Please refer to my
comments in cc file.

[miu, 2012/09/10 21:24:38]

wjia@ addressed this: VideoCaptureDevice is shared.

+  };
+  typedef std::map<int, DeviceEntry> VideoCaptureDevices;
   VideoCaptureDevices devices_;
 
   // Set to true if using fake devices for testing, false by default.
   bool use_fake_device_;
 
   // Only accessed from device thread.
   // VideoCaptureManager owns all VideoCaptureController's and is responsible
   // for deleting the instances when they are not used any longer.
   // VideoCaptureDevice is one-to-one mapped to VideoCaptureController.
   typedef std::map<media::VideoCaptureDevice*, Controller*> Controllers;
   Controllers controllers_;
 
   DISALLOW_COPY_AND_ASSIGN(VideoCaptureManager);
 };
 
 }  // namespace media_stream
 
 #endif  // CONTENT_BROWSER_RENDERER_HOST_MEDIA_VIDEO_CAPTURE_MANAGER_H_