tibrvEventVectorCallback
Function Type
Declaration
typedef void (*tibrvEventVectorCallback) (
tibrvMsg messages[],
tibrv_u32 numMessages);
Purpose
Programs define functions of this type to process message vector events.
Remarks
In the simplest arrangement, your callback function processes the messages in the array. When the callback function returns, the Rendezvous library deallocates the array.
If your application requires a more complex processing arrangement, it can detach individual messages, and pass them to other threads for processing. (If your program detaches a message, then it must also explicitly destroy it.)
It is illegal to pass the message array to a different thread for processing, or to use it as dynamically-allocated storage.
Notice that in contrast to tibrvEventCallback, this vector callback does not receive the listener event and the closure object as arguments. You can use tibrvMsg_GetEvent() and tibrvMsg_GetClosure() to get them from the individual message objects.
|
Parameter |
Description |
|
|
The callback receives an array of inbound messages in this parameter. |
|
|
This parameter receives the number of messages in the array. |