Filter
Top Products
188 Voice API for Windows Operating Systems Library Reference — November 2003
dx_dial( ) — dial an ASCIIZ string
dx_dial( )
dial an ASCIIZ string
!
!!
! Description
The dx_dial( ) function dials an ASCIIZ string on an open, idle channel and optionally enables call
progress analysis to provide information about the call. For detailed information on call progress
analysis, see the Voice API Programming Guide. For DM3 boards, see also the Global Call API
Programming Guide for information on call progress analysis.
To determine the state of the channel during a dial and/or call progress analysis, use
ATDX_STATE( ).
Notes: 1. dx_dial( ) doesn’t affect the hook state.
2. dx_dial( ) doesn’t wait for dial tone before dialing.
Name: int dx_dial(chdev, dialstrp, capp, mode)
Inputs: int chdev
• valid channel device handle
char *dialstrp
• pointer to the ASCIIZ dial string
DX_CAP *capp
• pointer to call progress analysis parameter structure
unsigned short mode
• asynchronous/synchronous setting and call progress analysis flag
Returns: 0 to indicate successful initiation (asynchronous)
≥0 to indicate call progress analysis result if successful (synchronous)
-1 if failure
Includes: srllib.h
dxxxlib.h
Category: I/O
Mode: asynchronous or synchronous
Platform: DM3, Springware
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was
opened using dx_open( )
dialstrp points to the ASCII dial string. dialstrp must contain a null-terminated
string of ASCII characters. For a list of valid dialing and control
characters, see Table 2 and Table 3.