Implementation of URLLoader using PluginResource/ResourceHost.

ppapi/c/ppp_instance.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.
  */
 
-/* From ppp_instance.idl modified Thu Jun 28 15:08:39 2012. */
+/* From ppp_instance.idl modified Thu Apr 25 13:07:47 2013. */
 
 #ifndef PPAPI_C_PPP_INSTANCE_H_
 #define PPAPI_C_PPP_INSTANCE_H_
 
 #include "ppapi/c/pp_bool.h"
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_macros.h"
 #include "ppapi/c/pp_point.h"
 #include "ppapi/c/pp_rect.h"
 #include "ppapi/c/pp_resource.h"
@@ skipping 122 matching lines @@
    * returning true from your event handler.
    *
    * @param[in] instance A <code>PP_Instance</code> identifying the instance
    * receiving the input event.
    *
    * @param[in] has_focus Indicates the new focused state of the instance.
    */
   void (*DidChangeFocus)(PP_Instance instance, PP_Bool has_focus);
   /**
    * HandleDocumentLoad() is called after initialize for a full-frame
-   * module that was instantiated based on the MIME type of a DOMWindow
+   * instance that was instantiated based on the MIME type of a DOMWindow
    * navigation. This situation only applies to modules that are pre-registered
    * to handle certain MIME types. If you haven't specifically registered to
    * handle a MIME type or aren't positive this applies to you, your
    * implementation of this function can just return <code>PP_FALSE</code>.
    *
    * The given <code>url_loader</code> corresponds to a
    * <code>PPB_URLLoader</code> instance that is already opened. Its response
    * headers may be queried using <code>PPB_URLLoader::GetResponseInfo</code>.
    * The reference count for the URL loader is not incremented automatically on
    * behalf of the module. You need to increment the reference count yourself
    * if you are going to keep a reference to it.
    *
    * This method returns <code>PP_FALSE</code> if the module cannot handle the
    * data. In response to this method, the module should call
    * ReadResponseBody() to read the incoming data.
    *
    * @param[in] instance A <code>PP_Instance</code> identifying the instance
    * that should do the load.
    *
    * @param[in] url_loader An open <code>PPB_URLLoader</code> instance.
    *
    * @return <code>PP_TRUE</code> if the data was handled,
-   * <code>PP_FALSE</code> otherwise.
+   * <code>PP_FALSE</code> otherwise.  If you return false, the load will be
+   * canceled for you.
    */
   PP_Bool (*HandleDocumentLoad)(PP_Instance instance, PP_Resource url_loader);
 };
 
 typedef struct PPP_Instance_1_1 PPP_Instance;
 
 struct PPP_Instance_1_0 {
   PP_Bool (*DidCreate)(PP_Instance instance,
                        uint32_t argc,
                        const char* argn[],
                        const char* argv[]);
   void (*DidDestroy)(PP_Instance instance);
   void (*DidChangeView)(PP_Instance instance,
                         const struct PP_Rect* position,
                         const struct PP_Rect* clip);
   void (*DidChangeFocus)(PP_Instance instance, PP_Bool has_focus);
   PP_Bool (*HandleDocumentLoad)(PP_Instance instance, PP_Resource url_loader);
 };
 /**
  * @}
  */
 
 #endif  /* PPAPI_C_PPP_INSTANCE_H_ */