diff options
Diffstat (limited to 'ppapi/c/ppp_messaging.h')
| -rw-r--r-- | ppapi/c/ppp_messaging.h | 16 |
1 files changed, 12 insertions, 4 deletions
diff --git a/ppapi/c/ppp_messaging.h b/ppapi/c/ppp_messaging.h index 1448bb1..b2e1f3c 100644 --- a/ppapi/c/ppp_messaging.h +++ b/ppapi/c/ppp_messaging.h @@ -3,7 +3,7 @@ * found in the LICENSE file. */ -/* From ppp_messaging.idl modified Wed Jan 25 11:41:09 2012. */ +/* From ppp_messaging.idl modified Tue May 21 09:01:17 2013. */ #ifndef PPAPI_C_PPP_MESSAGING_H_ #define PPAPI_C_PPP_MESSAGING_H_ @@ -45,9 +45,17 @@ struct PPP_Messaging_1_0 { * * @param[in] instance A <code>PP_Instance</code> identifying one instance * of a module. - * @param[in] message A <code>PP_Var</code> containing the data to be sent - * to JavaScript. Message can have an int32_t, double, bool, or string value - * (objects are not supported). + * @param[in] message A <code>PP_Var</code> which has been converted from a + * JavaScript value. JavaScript array/object types are supported from Chrome + * M29 onward. All JavaScript values are copied when passing them to the + * plugin. + * + * When converting JavaScript arrays, any object properties whose name + * is not an array index are ignored. When passing arrays and objects, the + * entire reference graph will be converted and transferred, including + * reference cycles if they exist. Since <code>PP_Var</code>s are ref-counted, + * the author of the plugin must take care if they expect to receive vars with + * cycles. Cycles must be manually broken to correctly release the vars. * * The following JavaScript code invokes <code>HandleMessage</code>, passing * the module instance on which it was invoked, with <code>message</code> |