Pepper_56_C_interfaces
Pepper_56_C_interfaces
|
#include <ppp_message_handler.h>
Public Attributes | |
void(* | HandleMessage )(PP_Instance instance, void *user_data, const struct PP_Var *message) |
void(* | HandleBlockingMessage )(PP_Instance instance, void *user_data, const struct PP_Var *message, struct PP_Var *response) |
void(* | Destroy )(PP_Instance instance, void *user_data) |
The PPP_MessageHandler
interface is implemented by the plugin if the plugin wants to receive messages from a thread other than the main Pepper thread, or if the plugin wants to handle blocking messages which JavaScript may send via postMessageAndAwaitResponse().
This interface struct should not be returned by PPP_GetInterface; instead it must be passed as a parameter to PPB_Messaging::RegisterMessageHandler.
void(* PPP_MessageHandler_0_2::Destroy)(PP_Instance instance, void *user_data) |
Invoked when the handler object is no longer needed. After this, no more calls will be made which pass this same value for instance
and user_data
.
[in] | instance | A PP_Instance identifying one instance of a module. |
[in] | user_data | is the same pointer which was provided by a call to RegisterMessageHandler. |
void(* PPP_MessageHandler_0_2::HandleBlockingMessage)(PP_Instance instance, void *user_data, const struct PP_Var *message, struct PP_Var *response) |
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.
[in] | instance | A PP_Instance identifying one instance of a module. |
[in] | user_data | is the same pointer which was provided by a call to RegisterMessageHandler(). |
[in] | message | is a copy of the parameter that JavaScript provided to postMessageAndAwaitResponse(). |
[out] | response | will be copied to a JavaScript object which is returned as the result of postMessageAndAwaitResponse() to the invoking |
void(* PPP_MessageHandler_0_2::HandleMessage)(PP_Instance instance, void *user_data, const struct PP_Var *message) |
Invoked as a result of JavaScript invoking postMessage() on the plugin's DOM element.
[in] | instance | A PP_Instance identifying one instance of a module. |
[in] | user_data | is the same pointer which was provided by a call to RegisterMessageHandler(). |
[in] | message | A copy of the parameter that JavaScript provided to postMessage(). |