474 Voice API for Windows Operating Systems Library Reference — November 2003
Events
The dx_setevtmsk( ) function enables detection of CST events. User-defined tones are CST events,
but detection for these events is enabled using dx_addtone( ) or dx_enbtone( ).
The dx_getevt( ) function retrieves CST events in a synchronous environment. Events are returned
to DX_EBLK, on page 506. To retrieve CST events in an asynchronous environment, use the
Standard Runtime Library (SRL) Event Management functions such as sr_getevtdatap( ). Events
are returned to the DX_CST structure.
Call Status Transition Events on DM3 BoardsOn DM3 boards, the following CST events may be returned by the voice library:
DE_DIGITS
Call status transition event. Indicates digit received. Returned by dx_getdig( ).
Instead of getting digits from the DV_DIGIT structure using dx_getdig( ), an alternative
method is to enable the DE_DIGITS call status transition event using dx_setevtmsk( ) and get
them from the DX_EBLK event queue data (ev_data) using dx_getevt( ) or from the DX_CST
call status transition data (cst_data) using sr_getevtdatap( ).
DE_DIGOFF
Call status transition event. Specifies digit tone off event.
DE_SILOFF
Call status transition event. Indicates non-silence detected on the channel.
DE_SILON
Call status transition event. Indicates silence detected on the channel.
DE_STOPGETEVT
Call status transition event. Indicates that the dx_getevt( ) function which was in progress has
been stopped.
DE_TONEOFF
Call status transition event. Indicates tone off event received.
DE_TONEON
Call status transition event. Indicates tone on event received.
Call Status Transition Events on Springware BoardsOn Springware boards, the following CST events may be returned by the voice library:
DE_DIGITS
Call status transition event. Indicates digit received. Returned by dx_getdig( ).
Instead of getting digits from the DV_DIGIT structure using dx_getdig( ), an alternative
method is to enable the DE_DIGITS call status transition event using dx_setevtmsk( ) and get
them from the DX_EBLK event queue data (ev_data) using dx_getevt( ) or from the DX_CST
call status transition data (cst_data) using sr_getevtdatap( ).
DE_DIGOFF
Call status transition event. Specifies digit tone off event.
DE_LCOFF
Call status transition event. Indicates loop current off.