• 5.3.1. DV_DIGIT Overview
• 5.3.2. DV_DIGIT Definition
• 5.3.3. DV_DIGIT Parameters

5.3. DV_DIGIT: User Digit Buffer

The DV_DIGIT data structure contains parameters for the User Digit Buffer.

5.3.1. DV_DIGIT Overview

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.

NOTE:

Instead of getting digits from the DV_DIGIT buffer 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( ).

5.3.2. DV_DIGIT Definition

The typedef for the structure is as follows:

    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;




5.3.3. DV_DIGIT Parameters

Parameter	Description
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. Use the following defines to identify the digit type:
	Define	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

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( ).

Click here to contact Dialogic Customer Engineering