Infrastructure for temportarily relinquishing GPU resources.

content/browser/gpu/gpu_process_host.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 CONTENT_BROWSER_GPU_GPU_PROCESS_HOST_H_
 #define CONTENT_BROWSER_GPU_GPU_PROCESS_HOST_H_
 
 #include <map>
 #include <queue>
 #include <set>
@@ skipping 46 matching lines @@
 
   typedef base::Callback<void(const IPC::ChannelHandle&, const gpu::GPUInfo&)>
       EstablishChannelCallback;
 
   typedef base::Callback<void(CreateCommandBufferResult)>
       CreateCommandBufferCallback;
 
   typedef base::Callback<void(const gfx::GpuMemoryBufferHandle& handle)>
       CreateGpuMemoryBufferCallback;
 
+  typedef base::Callback<void(bool successful)> RelinquishCallback;
+
   static bool gpu_enabled() { return gpu_enabled_; }
   static int gpu_crash_count() { return gpu_crash_count_; }
 
   // Creates a new GpuProcessHost or gets an existing one, resulting in the
   // launching of a GPU process if required.  Returns null on failure. It
   // is not safe to store the pointer once control has returned to the message
   // loop as it can be destroyed. Instead store the associated GPU host ID.
   // This could return NULL if GPU access is not allowed (blacklisted).
   CONTENT_EXPORT static GpuProcessHost* Get(GpuProcessKind kind,
                                             CauseForGpuLaunch cause);
 
   // Retrieves a list of process handles for all gpu processes.
   static void GetProcessHandles(
       const GpuDataManager::GetGpuProcessHandlesCallback& callback);
 
   // Helper function to send the given message to the GPU process on the IO
   // thread.  Calls Get and if a host is returned, sends it.  Can be called from
   // any thread.  Deletes the message if it cannot be sent.
   CONTENT_EXPORT static void SendOnIO(GpuProcessKind kind,
                                       CauseForGpuLaunch cause,
                                       IPC::Message* message);
 
   CONTENT_EXPORT static void RegisterGpuMainThreadFactory(
       GpuMainThreadFactoryFunction create);
 
+  // Relinquish all internal GPU driver resources. All windows should be closed
+  // and the browser is being set to be placed in the bacckground.
+  static void RelinquishResources(const RelinquishCallback& callback);
+
   // Get the GPU process host for the GPU process with the given ID. Returns
   // null if the process no longer exists.
   static GpuProcessHost* FromID(int host_id);
   int host_id() const { return host_id_; }
 
   // IPC::Sender implementation.
   bool Send(IPC::Message* msg) override;
 
   // Adds a message filter to the GpuProcessHost's channel.
   void AddFilter(IPC::MessageFilter* filter);
@@ skipping 67 matching lines @@
   void OnGpuMemoryBufferCreated(const gfx::GpuMemoryBufferHandle& handle);
   void OnDidCreateOffscreenContext(const GURL& url);
   void OnDidLoseContext(bool offscreen,
                         gpu::error::ContextLostReason reason,
                         const GURL& url);
   void OnDidDestroyOffscreenContext(const GURL& url);
   void OnGpuMemoryUmaStatsReceived(const GPUMemoryUmaStats& stats);
 #if defined(OS_MACOSX)
   void OnAcceleratedSurfaceBuffersSwapped(const IPC::Message& message);
 #endif
+  void RelinquishResourcesInternal(const RelinquishCallback& callback);
+  void OnResourcesRelinquished(bool success);
 
   void CreateChannelCache(int32 client_id);
   void OnDestroyChannel(int32 client_id);
   void OnCacheShader(int32 client_id, const std::string& key,
                      const std::string& shader);
 
   bool LaunchGpuProcess(const std::string& channel_id);
 
   void SendOutstandingReplies();
 
@@ skipping 34 matching lines @@
 
   // Whether we actually launched a GPU process.
   bool process_launched_;
 
   // Whether the GPU process successfully initialized.
   bool initialized_;
 
   // Time Init started.  Used to log total GPU process startup time to UMA.
   base::TimeTicks init_start_time_;
 
+  // Completion callback for RelinquishResources.
+  RelinquishCallback relinquish_callback_;
+
   // Whether this host recorded a GPU crash or not.
   bool gpu_crash_recorded_;
 
   // Master switch for enabling/disabling GPU acceleration for the current
   // browser session. It does not change the acceleration settings for
   // existing tabs, just the future ones.
   static bool gpu_enabled_;
 
   static bool hardware_gpu_enabled_;
 
@@ skipping 34 matching lines @@
   typedef std::multimap<int, scoped_refptr<GpuSurfaceTracker::SurfaceRef> >
       SurfaceRefMap;
   SurfaceRefMap surface_refs_;
 
   DISALLOW_COPY_AND_ASSIGN(GpuProcessHost);
 };
 
 }  // namespace content
 
 #endif  // CONTENT_BROWSER_GPU_GPU_PROCESS_HOST_H_