refactor VideoCaptureHost and VideoCaptureController.

content/browser/renderer_host/media/video_capture_controller.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.
 
 // VideoCaptureController is the glue between VideoCaptureHost,
 // VideoCaptureManager and VideoCaptureDevice.
 // It provides functions for VideoCaptureHost to start a VideoCaptureDevice and
 // is responsible for keeping track of shared DIBs and filling them with I420
 // video frames for IPC communication between VideoCaptureHost and
 // VideoCaptureMessageFilter.
@@ skipping 33 matching lines @@
   // |params|.
   // When capturing has started, the |event_handler| receives a call OnFrameInfo
   // with resolution that best matches the requested that the video
   // capture device support.
   void StartCapture(const VideoCaptureControllerID& id,
                     VideoCaptureControllerEventHandler* event_handler,
                     base::ProcessHandle render_process,
                     const media::VideoCaptureParams& params);
 
   // Stop video capture.
-  // When the capture is stopped and all DIBs have been returned,
-  // VideoCaptureControllerEventHandler::OnReadyToDelete will be called.
-  // |force_buffer_return| allows controller to take back all buffers used
-  // by |event_handler|.
+  // This will take back all buffers held by by |event_handler|, and
+  // |event_handler| shouldn't use those buffers any more.
   void StopCapture(const VideoCaptureControllerID& id,
-                   VideoCaptureControllerEventHandler* event_handler,
-                   bool force_buffer_return);
+                   VideoCaptureControllerEventHandler* event_handler);
 
   // API called directly by VideoCaptureManager in case the device is
   // prematurely closed.
   void StopSession(int session_id);
 
   // Return a buffer previously given in
   // VideoCaptureControllerEventHandler::OnBufferReady.
   void ReturnBuffer(const VideoCaptureControllerID& id,
                     VideoCaptureControllerEventHandler* event_handler,
                     int buffer_id);
@@ skipping 70 matching lines @@
 
   media_stream::VideoCaptureManager* video_capture_manager_;
 
   bool device_in_use_;
   video_capture::State state_;
 
   DISALLOW_IMPLICIT_CONSTRUCTORS(VideoCaptureController);
 };
 
 #endif  // CONTENT_BROWSER_RENDERER_HOST_MEDIA_VIDEO_CAPTURE_CONTROLLER_H_