diff options
| author | dmichael <dmichael@chromium.org> | 2014-09-18 11:00:29 -0700 |
|---|---|---|
| committer | Commit bot <commit-bot@chromium.org> | 2014-09-18 18:00:46 +0000 |
| commit | b8737917043275c52ae682cddc6604c495d2e73f (patch) | |
| tree | e9e333fe6377a717160e4cf52b15393c85e07db6 /ppapi/api | |
| parent | 54f98657d48d67fdb4d0097e7a9f906cc52f9378 (diff) | |
| download | chromium_src-b8737917043275c52ae682cddc6604c495d2e73f.zip chromium_src-b8737917043275c52ae682cddc6604c495d2e73f.tar.gz chromium_src-b8737917043275c52ae682cddc6604c495d2e73f.tar.bz2 | |
PPAPI: Add C++ wrapper for MessageHandler stuff.
BUG=367896
Review URL: https://codereview.chromium.org/318763003
Cr-Commit-Position: refs/heads/master@{#295495}
Diffstat (limited to 'ppapi/api')
| -rw-r--r-- | ppapi/api/ppp_message_handler.idl | 13 |
1 files changed, 9 insertions, 4 deletions
diff --git a/ppapi/api/ppp_message_handler.idl b/ppapi/api/ppp_message_handler.idl index e898f0b..7d76040 100644 --- a/ppapi/api/ppp_message_handler.idl +++ b/ppapi/api/ppp_message_handler.idl @@ -32,7 +32,7 @@ interface PPP_MessageHandler { * @param[in] instance A <code>PP_Instance</code> identifying one instance * of a module. * @param[in] user_data is the same pointer which was provided by a call to - * RegisterMessageHandler. + * RegisterMessageHandler(). * @param[in] message A copy of the parameter that JavaScript provided to * postMessage(). */ @@ -43,14 +43,19 @@ interface PPP_MessageHandler { * Invoked as a result of JavaScript invoking postMessageAndAwaitResponse() * on the plugin's DOM element. * + * NOTE: JavaScript execution is blocked during the duration of this call. + * Hence, the plugin should respond as quickly as possible. For this reason, + * blocking completion callbacks are disallowed while handling a blocking + * message. + * * @param[in] instance A <code>PP_Instance</code> identifying one instance * of a module. * @param[in] user_data is the same pointer which was provided by a call to - * RegisterMessageHandler. + * RegisterMessageHandler(). * @param[in] message is a copy of the parameter that JavaScript provided - * to postMessageAndAwaitResponse. + * to postMessageAndAwaitResponse(). * @param[out] response will be copied to a JavaScript object which is - * returned as the result of postMessageAndAwaitResponse to the invoking + * returned as the result of postMessageAndAwaitResponse() to the invoking JavaScript. */ void HandleBlockingMessage([in] PP_Instance instance, |