Filter
Top Products
506 Voice API for Windows Operating Systems Library Reference — November 2003
DX_EBLK — call status transition event block
DX_EBLK
call status transition event block
typedef struct DX_EBLK {
unsigned short ev_event; /* Event that occurred */
unsigned short ev_data; /* Event specific data */
unsigned char ev_rfu[12]; /* Reserved for future use*/
}DX_EBLK;
!
!!
! Description
The DX_EBLK data structure contains parameters for the Call Status Event Block. This structure
is returned by dx_getevt( ) and indicates which call status transition event occurred. dx_getevt( ) is
a synchronous function which blocks until an event occurs. For information about asynchronously
waiting for CST events, see dx_setevtmsk( ).
!
!!
! Field Descriptions
The fields of the DX_EBLK data structure are described as follows:
ev_event
Contains the event type. Use the following defines to identify the event type:
• DE_DIGITS – digit received
• DE_LCOFF – loop current off
• DE_LCON – loop current on
• DE_LCREV – loop current reversal
• DE_RINGS – rings received
• DE_SILOFF – non-silence detected
• DE_SILON – silence detected
• DE_TONEOFF – tone off event
• DE_TONEON – tone on event
• DE_WINK – received a wink
• DX_OFFHOOK – offhook event
• DX_ONHOOK – onhook event
DX_ONHOOK and DX_OFFHOOK are returned if a TDX_SETHOOK termination event is
received.
ev_data
Contains data associated with the CST event. All durations of time are in 10 msec units. The
data are described for each event type as follows:
• DE_DIGITS – ASCII digit (low byte) and the digit type (high byte)
• DE_LCOFF – length of time that loop current was on before the loop-current-off event
was detected
• DE_LCON – length of time that loop current was off before the loop-current-on event was
detected
• DE_LCREV – length of time that loop current was reversed before the loop-current-
reversal event was detected
• DE_RINGS – 0 (no data)
• DE_SILOFF – length of time that silence occurred before non-silence (noise or
meaningful sound) was detected
• DE_SILON – length of time that non-silence occurred before silence was detected
• DE_TONEOFF – user-specified tone ID for the tone-off event