Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 483
user digit buffer — DV_DIGIT
DV_DIGIT
user digit buffer
typedef struct DV_DIGIT {
char dg_value[DG_MAXDIGS +1]; /* ASCII values of digits */
char dg_type[DG_MAXDIGS +1]; /* Type of digits */
} DV_DIGIT;
!
!!
! Description
The DV_DIGIT data structure stores an array of digits.When a dx_getdig( ) is performed, the
digits are collected from the firmware and transferred to the user’s digit buffer. The digits are stored
as an array inside the DV_DIGIT structure.
The DG_MAXDIGS define in dxxxlib.h indicates the maximum number of digits (31) that can be
returned by a single call to dx_getdig( ).
Note: 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( ).
!
!!
! Field Descriptions
The fields of the DV_DIGIT data structure are described as follows:
dg_value
Specifies a NULL-terminated string of the ASCII values of the digits collected.
dg_type
Specifies an array (terminated by DG_END) of the digit types that correspond to each of the
digits contained in the dg_value string.
On DM3 boards, use the following defines to identify the digit type:
• DG_DTMF_ASCII – DTMF
• DG_DPD_ASCII – DPD (dial pulse)
• DG_MF_ASCII – MF
• DG_USER1 – GTD user-defined
• DG_USER2 – GTD user-defined
• DG_USER3 – GTD user-defined
• DG_USER4 – GTD user-defined
• DG_USER5 – GTD user-defined
• DG_END – Terminator for dg_type array
On Springware boards, use the following defines to identify the digit type:
• DG_DTMF_ASCII – DTMF
• DG_DPD_ASCII – DPD (dial pulse)
• DG_MF_ASCII – MF
• DG_USER1_ASCII – GTD user-defined
• DG_USER2_ASCII – GTD user-defined
• DG_USER3_ASCII – GTD user-defined
• DG_USER4_ASCII – GTD user-defined
• DG_USER5_ASCII – GTD user-defined
• DG_END – Terminator for dg_type array