PPP_MessageHandler_0_2 Struct Reference

#include <ppp_message_handler.h>

Collaboration diagram for PPP_MessageHandler_0_2:

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)

Detailed Description

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.

Definition at line 39 of file ppp_message_handler.h.

Member Data Documentation

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.

Parameters

[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.

Definition at line 87 of file ppp_message_handler.h.

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.

Parameters

[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

Definition at line 73 of file ppp_message_handler.h.

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.

Parameters

[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().

Definition at line 51 of file ppp_message_handler.h.

---

The documentation for this struct was generated from the following file:

• ppp_message_handler.h