TibrvVectorCallback::onMsgs()
Method
Declaration
virtual voidonMsgs(
TibrvMsg* mesages[],
tibrv_u32 numMessages) = 0;
Purpose
Process inbound message vectors (vector listener events).
|
Parameter |
Description |
|
|
This parameter receives an array of pointers to inbound messages. |
|
|
This parameter receives the number of messages in the array. |
Remarks
Implement this method to process inbound message vectors.
In the simplest arrangement, your callback method processes the messages in the array. When the callback method 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 TibrvMsgCallback::onMsg(), this vector callback does not receive the listener event as an argument. You can use TibrvMsg::getEvent() to get it from the individual message objects.