src/ppapi/api/private/ppp_instance_private.idl

   1 /* Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2  * Use of this source code is governed by a BSD-style license that can be
   3  * found in the LICENSE file.
   4  */
   5
   6 /**
   7  * This file defines the PPP_InstancePrivate structure; a series of functions
   8  * that a trusted plugin may implement to provide capabilities only available
   9  * to trusted plugins.
  10  */
  11 label Chrome {
  12   M18 = 0.1
  13 };
  14
  15 /**
  16  * The PPP_Instance_Private interface contains pointers to a series of
  17  * functions that may be implemented in a trusted plugin to provide capabilities
  18  * that aren't possible in untrusted modules.
  19  */
  20
  21 interface PPP_Instance_Private {
  22   /**
  23    * GetInstanceObject returns a PP_Var representing the scriptable object for
  24    * the given instance. Normally this will be a PPP_Class_Deprecated object
  25    * that exposes methods and properties to JavaScript.
  26    *
  27    * On Failure, the returned PP_Var should be a "void" var.
  28    *
  29    * The returned PP_Var should have a reference added for the caller, which
  30    * will be responsible for Release()ing that reference.
  31    *
  32    * @param[in] instance A PP_Instance identifying the instance from which the
  33    *            instance object is being requested.
  34    * @return A PP_Var containing scriptable object.
  35    */
  36   PP_Var GetInstanceObject([in] PP_Instance instance);
  37 };