New tabCapture.captureOffscreenTab API, initially for Presentation API 1UA mode

chrome/browser/extensions/api/tab_capture/tab_capture_registry.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 CHROME_BROWSER_EXTENSIONS_API_TAB_CAPTURE_TAB_CAPTURE_REGISTRY_H_
 #define CHROME_BROWSER_EXTENSIONS_API_TAB_CAPTURE_TAB_CAPTURE_REGISTRY_H_
 
 #include <string>
 #include <utility>
 #include <vector>
@@ skipping 31 matching lines @@
   static BrowserContextKeyedAPIFactory<TabCaptureRegistry>*
       GetFactoryInstance();
 
   // List all pending, active and stopped capture requests.
   void GetCapturedTabs(const std::string& extension_id,
                        base::ListValue* list_of_capture_info) const;
 
   // Add a tab capture request to the registry when a stream is requested
   // through the API.  |target_contents| refers to the WebContents associated
   // with the tab to be captured.  |extension_id| refers to the Extension
-  // initiating the request.
+  // initiating the request.  |is_anonymous| is true if GetCapturedTabs() should
+  // not list the captured tab, and no status change events should be dispatched
+  // for it.
+  //
+  // TODO(miu): This is broken in that it's possible for a later WebContents
+  // instance to have the same pointer value as a previously-destroyed one.  To
+  // be fixed while working on http://crbug.com/163100.
   bool AddRequest(content::WebContents* target_contents,
-                  const std::string& extension_id);
+                  const std::string& extension_id,
+                  bool is_anonymous);
 
   // Called by MediaStreamDevicesController to verify the request before
   // creating the stream.  |render_process_id| and |render_frame_id| are used to
   // look-up a WebContents instance, which should match the |target_contents|
   // from the prior call to AddRequest().  In addition, a request is not
   // verified unless the |extension_id| also matches AND the request itself is
   // in the PENDING state.
   bool VerifyRequest(int render_process_id,
                      int render_frame_id,
                      const std::string& extension_id);
@@ skipping 41 matching lines @@
 
   ScopedObserver<ExtensionRegistry, ExtensionRegistryObserver>
       extension_registry_observer_;
 
   DISALLOW_COPY_AND_ASSIGN(TabCaptureRegistry);
 };
 
 }  // namespace extensions
 
 #endif  // CHROME_BROWSER_EXTENSIONS_API_TAB_CAPTURE_TAB_CAPTURE_REGISTRY_H_