Implementation of URLLoader using PluginResource/ResourceHost.

ppapi/api/ppp_instance.idl

 /* 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.
  */
 
 /**
  * This file defines the <code>PPP_Instance</code> structure - a series of
  * pointers to methods that you must implement in your module.
  */
 
@@ skipping 189 matching lines @@
    * @param[in] has_focus Indicates the new focused state of the instance.
    */
   void DidChangeFocus(
       /* A PP_Instance identifying one instance of a module. */
       [in] PP_Instance instance,
       /* Indicates whether this NaCl module gained or lost event focus. */
       [in] 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(
       /* A PP_Instance identifying one instance of a module. */
       [in] PP_Instance instance,
       /* A PP_Resource an open PPB_URLLoader instance. */
       [in] PP_Resource url_loader);
 
 };