This following table describes the H.324M events that can be sent by the H.324M Middleware to the application:
Event |
Description |
H324EVN_CALL_SETUP_FAILED |
Call setup failed due to a failure of either the master slave determination process or the terminal capabilities exchange process. One of the following reason codes is returned: H324RSN_TERM_CAP_REJECT_UNSPECIFIED H324RSN_TERM_CAP_REJECT_ H324RSN_TERM_CAP_REJECT_ H324RSN_TERM_CAP_REJECT_ H324RSN_TERM_CAP_TIME_OUT H324RSN_MASTER_SLAVE_ERROR H324RSN_UNSPECIFIED Shut down the call by calling h324Stop and h324Delete. |
H324EVN_CHANNEL_CLOSED |
Either the application or the remote terminal successfully closed a channel. The type of the channel closed is indicated in the event size field, which contains one of the following values: H324RSN_AUDIO_IN H324RSN_AUDIO_OUT H324RSN_VIDEO H324RSN_VIDEO_IN H324RSN_VIDEO_OUT |
H324EVN_CHANNEL_CLOSE_FAILED |
Remote terminal rejected the request to close the specified channel. |
H324EVN_END_SESSION |
Remote terminal issued an H.245 EndSession command, which initiates call teardown. Once this command is issued, the only calls the H.324M Middleware expects are h324Stop and h324Delete. The Middleware also does not expect any further incoming H.324 events, except for H324EVN_STOP_DONE. Note: Many terminals do not send H324EVN_END_SESSION prior to terminating the call. |
H324EVN_END_SESSION_DONE |
End session message was delivered to the remote terminal. |
H324EVN_END_SESSION_TIMER_EXPIRED |
Internal event that normally gets consumed by h324SubmitEvent. If the event is not consumed, the application must ignore it. The event may not be consumed if the corresponding instance of the H.245 stack was destroyed before submitting the event to the H.324M Middleware. |
H324EVN_FAST_CALL_SETUP_DONE |
Call was set up using MONA (Media Oriented Negotiation Acceleration Procedures), which is defined in Annex K/H.324. For more information, see Enabling fast call setup. |
H324EVN_H223_SKEW_INDICATION |
H.223 skew indication message from the remote terminal. This message indicates that one channel (either audio or video) is delayed with respect to the other. The application must apply a corresponding delay to the other channel to resynchronize playback of the two channels. The 3G-324M Interface does not provide a resynchronization mechanism. The event buffer contains this message in a structure of type H324_H223_SKEW_INDICATION. |
H324EVN_H245_INTERNAL_ERROR |
H.245 stack declared an internal error of an undefined type. The recommended resolution is to terminate the call. |
H324EVN_INTERNAL_EVENT |
Internal event that gets consumed by h324SubmitEvent. |
H324EVN_LCD |
One of the following:
The contents of this set are reflected in the event buffer as a structure of type H324_LCD. |
H324EVN_MEDIA_SETUP_DONE |
All of the following conditions have been met:
|
H324EVN_MEDIA_SETUP_FAILED |
Media setup failed due to a failure of either the multiplex entry table, or one of the audio channels. One of the following reason codes is returned: H324RSN_MUX_TABLE_REJECT_UNSPECIFIED H324RSN_MUX_TABLE_ H324RSN_INBOUND_AUDIO_CHANNEL_FAILURE H324RSN_OUTBOUND_AUDIO_CHANNEL_FAILURE H324RSN_LCSE_ERROR_INDICATION H324RSN_UNSPECIFIED Shut down the call by calling h324Stop and h324Delete. |
H324EVN_PASSTHRU_DTMF_MODE_DONE |
DTMF mode and payload ID were reset. |
H324EVN_PASSTHRU_PLAY_RFC2833_DONE |
RFC 2833 DTMF digits are passed to the IP side as RTP-encapsulated packets. |
H324EVN_REMOTE_CAPABILITIES |
Message from the remote terminal that conveys its set of terminal capabilities. Event buffer contains this information in a structure of type H324_TERM_CAPS. |
H324EVN_ROUND_TRIP_DELAY |
Results of round trip delay request. |
H324EVN_ROUND_TRIP_TIMEOUT |
Timeout after a round trip delay message was sent. |
H324EVN_START_DONE |
Received when the H.245 stack creation is complete. The event value indicates success or failure. One of the following reason codes can be returned: CTA_REASON_FINISHED – Returned if the call to h324Start was successful. CTA_REASON_TIMEOUT – Returned if there was a H.223 level synchronization problem with the remote terminal. |
H324EVN_START_TIMER_EXPIRED |
Internal event to be consumed by h324SubmitEvent. If the H324EVN_START_TIMER_EXPIRED event is not consumed, the application must ignore it. The event is not consumed if the corresponding instance of the H.245 stack was destroyed before submitting the event to the H.324M Middleware. |
H324EVN_STOP_DONE |
Received when the H.245 stack destruction is complete. The event value indicates success or failure. The application must call h324Delete when this event is received. |
H324EVN_USER_INDICATION |
User indication message from the remote terminal. The event buffer contains this message in a structure of type H324_USER_INPUT_INDICATION. |
H324EVN_VENDORID_INDICATION |
Vendor indication message from the remote terminal. The event buffer contains this message in a structure of type H324_VENDORID_INDICATION. |
H324EVN_VIDEO_CHANNEL_SETUP_FAILED |
After multiple retries, the H.324M Middleware could not establish a bi-directional video channel. The call can continue as an audio only call, or can be shut down by calling h324Stop and h324Delete. |
H324EVN_VIDEO_FAST_UPDATE |
Request from the remote terminal for a video fast update. |
H324EVN_VIDEO_OLC_TIMER_EXPIRED |
Internal event to be consumed by h324SubmitEvent. If the event is not consumed, the application must ignore it. The event may not be consumed if the corresponding instance of the H.245 stack was destroyed before submitting the event to the H.324M Middleware. |
H324EVN_ |
Message from the remote terminal that conveys the temporal-spatial tradeoff indication for the terminal's outbound video channel. The event buffer contains this information in a structure of type H324_VIDEOTEMPORALSPATIALTRADEOFF_INDICATION. |