1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style license that can be 3 // found in the LICENSE file. 4 5 // Windows specific implementation of VideoCaptureDevice. 6 // DirectShow is used for capturing. DirectShow provide its own threads 7 // for capturing. 8 9 #ifndef MEDIA_VIDEO_CAPTURE_WIN_VIDEO_CAPTURE_DEVICE_WIN_H_ 10 #define MEDIA_VIDEO_CAPTURE_WIN_VIDEO_CAPTURE_DEVICE_WIN_H_ 11 12 // Avoid including strsafe.h via dshow as it will cause build warnings. 13 #define NO_DSHOW_STRSAFE 14 #include <dshow.h> 15 16 #include <map> 17 #include <string> 18 19 #include "base/threading/non_thread_safe.h" 20 #include "base/threading/thread.h" 21 #include "base/win/scoped_comptr.h" 22 #include "media/video/capture/video_capture_device.h" 23 #include "media/video/capture/video_capture_types.h" 24 #include "media/video/capture/win/capability_list_win.h" 25 #include "media/video/capture/win/sink_filter_win.h" 26 #include "media/video/capture/win/sink_input_pin_win.h" 27 28 namespace media { 29 30 // All the methods in the class can only be run on a COM initialized thread. 31 class VideoCaptureDeviceWin 32 : public base::NonThreadSafe, 33 public VideoCaptureDevice, 34 public SinkFilterObserver { 35 public: 36 explicit VideoCaptureDeviceWin(const Name& device_name); 37 virtual ~VideoCaptureDeviceWin(); 38 // Opens the device driver for this device. 39 // This function is used by the static VideoCaptureDevice::Create function. 40 bool Init(); 41 42 // VideoCaptureDevice implementation. 43 virtual void Allocate(const VideoCaptureCapability& capture_format, 44 VideoCaptureDevice::EventHandler* observer) OVERRIDE; 45 virtual void Start() OVERRIDE; 46 virtual void Stop() OVERRIDE; 47 virtual void DeAllocate() OVERRIDE; 48 virtual const Name& device_name() OVERRIDE; 49 50 static void GetDeviceNames(Names* device_names); 51 52 private: 53 enum InternalState { 54 kIdle, // The device driver is opened but camera is not in use. 55 kAllocated, // The camera has been allocated and can be started. 56 kCapturing, // Video is being captured. 57 kError // Error accessing HW functions. 58 // User needs to recover by destroying the object. 59 }; 60 61 // Implements SinkFilterObserver. 62 virtual void FrameReceived(const uint8* buffer, int length); 63 64 bool CreateCapabilityMap(); 65 void SetErrorState(const char* reason); 66 67 Name device_name_; 68 InternalState state_; 69 VideoCaptureDevice::EventHandler* observer_; 70 71 base::win::ScopedComPtr<IBaseFilter> capture_filter_; 72 base::win::ScopedComPtr<IGraphBuilder> graph_builder_; 73 base::win::ScopedComPtr<IMediaControl> media_control_; 74 base::win::ScopedComPtr<IPin> input_sink_pin_; 75 base::win::ScopedComPtr<IPin> output_capture_pin_; 76 // Used when using a MJPEG decoder. 77 base::win::ScopedComPtr<IBaseFilter> mjpg_filter_; 78 base::win::ScopedComPtr<IPin> input_mjpg_pin_; 79 base::win::ScopedComPtr<IPin> output_mjpg_pin_; 80 81 scoped_refptr<SinkFilter> sink_filter_; 82 83 // Map of all capabilities this device support. 84 CapabilityList capabilities_; 85 86 DISALLOW_IMPLICIT_CONSTRUCTORS(VideoCaptureDeviceWin); 87 }; 88 89 } // namespace media 90 91 #endif // MEDIA_VIDEO_CAPTURE_WIN_VIDEO_CAPTURE_DEVICE_WIN_H_ 92