# h324SubmitEvent

Submits a Natural Access event from the event queue to the H.324M Middleware.

#### Prototype

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 values

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.

#### Events

None.

#### Details

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.

#### See also

h324FormatEvent

#### Example

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 */
}