Submits a Natural Access event from the event queue to the H.324M Middleware.
DWORD h324SubmitEvent ( CTA_EVENT *event, H324_BOOL *consumed)
Argument |
Description |
event |
Pointer to an event received from ctaWaitEvent. |
consumed |
Pointer to a returned value indicating whether the H.324M Middleware consumed the event. |
Return value |
Description |
SUCCESS |
|
H324ERR_COMMAND_RESPONSE_ERROR |
A command done event was received from an unexpected command. |
H324ERR_INCOMING_MSG_ERROR |
Error processing an incoming H.245 message. |
H324ERR_INTERNAL_ERROR |
Internal error in the H.324M Middleware. |
H324ERR_MUTEX_LOCK_FAILED |
Internal error trying to lock mutex. |
H324ERR_PMSYNC_ERROR |
Error after multiplexer synchronizes with remote multiplexer. |
None.
h324SubmitEvent can either consume or not consume each event submitted to it. If the event is consumed, the application continues to wait for additional Natural Access events. If the event is not consumed, it is an event for the application, which should process it normally.
The application does not need to release MSPP buffers associated with events that are consumed by h324SubmitEvent. These buffers are released by the H.324M Middleware.
CTA_EVENT event;
H324_BOOL consumed;
while(1)
{
ctaWaitEvent(ctaqueuehd, &event, CTA_WAIT_FOREVER);
ret = h324SubmitEvent(&event, &consumed);
if(ret != SUCCESS)
{
/* Error processing */
}
else if(consumed)
continue;
/* Normal application event processing goes here */
}