Filter
Top Products
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 Boards
On 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 Boards
On 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.