Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 377
enable detection of call status transition (CST) events — dx_setevtmsk( )
dx_setevtmsk( )
enable detection of call status transition (CST) events
!
!!
! Description
The dx_setevtmsk( ) function enables detection of call status transition (CST) event or group of
events. This function can be used by synchronous or asynchronous applications waiting for a CST
event.
When you enable detection of a CST event and the event occurs, it will be placed on the event
queue. You can collect the event by getting it or waiting for it with an event handling function, such
as sr_waitevt( ), sr_waitevtEx( ), or dx_getevt( ). For a list of call status transition events, see
Section 3.4, “Call Status Transition (CST) Events”, on page 473.
Notes: 1. This function can enable detection for all CST events except user-defined tone detection. See
dx_addtone( ) and dx_enbtone( ) for information.
2. The dx_wtring( ) function affects CST events that are enabled. It enables detection of the
DM_RINGS event and disables detection of other events.
Name: int dx_setevtmsk(chdev, mask)
Inputs: int chdev
• valid channel device handle
unsigned int mask
• event mask of events to enable
Returns: 0 if successful
-1 if failure
Includes: srllib.h
dxxxlib.h
Category: Call Status Transition Event
Mode: synchronous
Platform: DM3, Springware