Filter
Top Products
378 Voice API for Windows Operating Systems Library Reference — November 2003
dx_setevtmsk( ) — enable detection of call status transition (CST) events
If DM_DIGITS is specified, a digits flag is set that causes individual digit events to queue until this
flag is turned off by DM_DIGOFF. Setting the event mask for DM_DIGITS and then subsequently
resetting the event mask without DM_DIGITS does not disable the queueing of digit events. Digit
events will remain in the queue until collected by an event handling function such as sr_waitevt( ),
sr_waitevtEx( ), or dx_getevt( ). The event queue is not affected by dx_getdig( ) calls.
To enable DM_DIGITS:
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was
opened using dx_open( )
mask specifies the events to enable. To poll for multiple events, perform an OR
operation on the bit masks of the events you want to enable. The first enabled
CST event to occur will be returned. If an event is not specified in the mask,
the event will be disabled. If an event is enabled, it will remain enabled until it
is disabled through another function call; exceptions are DM_DIGITS and
DM_DIGOFF.
On DM3 boards, one or more of the following bits can be set:
• DM_SILOF – wait for non-silence
• DM_SILON – wait for silence
• DM_DIGITS – enable digit reporting on the event queue (each detected
digit is reported as a separate event on the event queue)
• DM_DIGOFF – disable digit reporting on the event queue (as enabled by
DM_DIGITS). This is the only way to disable DM_DIGITS.
• DM_UNDERRUN – enables firmware underrun reporting
(TDX_UNDERRUN event) for streaming to board feature. This mask
works like a toggle key. If set once, the next call to the function will unset
this mask.
On Springware boards, one or more of the following bits can be set:
• DM_LCOFF – wait for loop current to be off
• DM_LCON – wait for loop current to be on
• DM_RINGS – wait for rings; see also dx_wtring( )
• DM_RNGOFF – wait for ring to drop (hang-up)
• DM_SILOF – wait for non-silence
• DM_SILON – wait for silence
• DM_WINK – wait for wink to occur on an E&M line. If DM_WINK is not
enabled and DM_RINGS is enabled, a wink may be interpreted as an
incoming call, depending upon the setting of the DXBD_R_ON
parameter.
• DM_DIGITS – enable digit reporting on the event queue (each detected
digit is reported as a separate event on the event queue)
• DM_DIGOFF – disable digit reporting on the event queue (as enabled by
DM_DIGITS). This is the only way to disable DM_DIGITS.
• DM_LCREV – wait for flow of current to reverse. When the DM_LCREV
bit is enabled, a DE_LCREV event message is queued when the flow of
current over the line is reversed.