Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 189
dial an ASCIIZ string — dx_dial( )
Valid Dial String Characters
On DM3 boards, the following is a list of valid dialing and control characters.
When using dx_dial( ) on DM3 boards, be aware of the following considerations:
capp points to the call progress analysis parameter structure, DX_CAP.
To use the default call progress analysis parameters, specify NULL in
capp and DX_CALLP in mode.
mode specifies whether the ASCIIZ string will be dialed with or without call
progress analysis enabled, and whether the function will run
asynchronously or synchronously. This parameter is a bit mask that can be
set to a combination of the following values:
• DX_CALLP – enables call progress analysis
• EV_ASYNC – runs dx_dial( ) asynchronously
• EV_SYNC – runs dx_dial( ) synchronously (default)
On Springware boards, to enable call progress analysis (PerfectCall), you
must call dx_initcallp( ) prior to calling dx_dial( ). Otherwise, dx_dial( )
uses basic call progress analysis.
If dx_dial( ) with call progress analysis is performed on a channel that is
onhook, the function will only dial digits. Call progress analysis will not
occur.
On DM3 boards, call progress analysis (PerfectCall) is enabled directly
through dx_dial( ). The dx_initcallp( ) function is not supported.
Parameter Description
Table 2. Valid Dial String Characters (DM3)
Characters Description
Valid in Dial Mode
DTMF MF
On Keypad
0 1 2 3 4 5 6 7 8 9 digits Yes Yes
* asterisk or star Yes Yes (KP)
# pound, hash, number, or octothorpe Yes Yes (ST)
Not on Keypad
a Yes Yes (ST1)
b Yes Yes (ST2)
c Yes Yes (ST3)
dYes
Special Control
, pause for 2.5 seconds (comma) Yes Yes
T Dial Mode: Tone (DTMF) (default) Yes Yes
M Dial Mode: MF Yes Yes