Allow renderer to create pepper ResourceHosts in the browser

content/public/renderer/renderer_ppapi_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_PUBLIC_RENDERER_RENDERER_PPAPI_HOST_H_
 #define CONTENT_PUBLIC_RENDERER_RENDERER_PPAPI_HOST_H_
 
 #include "base/memory/ref_counted.h"
 #include "base/platform_file.h"
 #include "base/process.h"
 #include "content/common/content_export.h"
 #include "ipc/ipc_platform_file.h"
 #include "ppapi/c/pp_instance.h"
 #include "webkit/plugins/ppapi/plugin_delegate.h"
 
 namespace base {
 class FilePath;
 }
 
 namespace gfx {
 class Point;
 }
 
 namespace IPC {
 struct ChannelHandle;
+class Message;
 }
 
 namespace ppapi {
 class PpapiPermissions;
 namespace host {
 class PpapiHost;
 }
 }
 
 namespace WebKit {
@@ skipping 93 matching lines @@
   // message fails, the returned handle is properly closed by the IPC system. If
   // |should_close_source| is set to true, the original handle is closed by this
   // operation and should not be used again.
   virtual IPC::PlatformFileForTransit ShareHandleWithRemote(
       base::PlatformFile handle,
       bool should_close_source) = 0;
 
   // Returns true if the plugin is running in process.
   virtual bool IsRunningInProcess() const = 0;
 
+  // There are times when the renderer needs to create a ResourceHost in the
+  // browser. This function does so asynchronously. |nested_msg| is the
+  // resource host creation message and |instance| is the PP_Instance which
+  // the resource will belong to. |callback| will be called with the pending
+  // host ID when the ResourceHost has been created. This can be passed back
+  // to the plugin to attach to the ResourceHost. A pending ID of 0 will be
+  // returned upon error.

[teravest, 2013/05/29 15:19:36]

small nit: Should this be "sent to the callback" instead of returned?

[raymes, 2013/05/29 15:53:03]

Done.

+  virtual void CreateBrowserResourceHost(
+      PP_Instance instance,
+      const IPC::Message& nested_msg,
+      base::Callback<void(int)> callback) const = 0;
+
  protected:
   virtual ~RendererPpapiHost() {}
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_RENDERER_RENDERER_PPAPI_HOST_H_