Intel 05-1832-002 User Manual
272
Voice API for Windows Operating Systems Library Reference — November 2003
dx_initcallp( ) — initialize and activate call progress analysis
dx_initcallp( )
initialize and activate call progress analysis
!
!
!
! Description
On Springware boards, the dx_initcallp( ) function initializes and activates call progress analysis
on the channel identified by chdev. In addition, this function adds all tones used in call progress
analysis to the channel’s global tone detection (GTD) templates.
on the channel identified by chdev. In addition, this function adds all tones used in call progress
analysis to the channel’s global tone detection (GTD) templates.
On DM3 boards, call progress analysis is enabled directly through the
function.
On Springware boards, to use call progress analysis, dx_initcallp( ) must be called prior to using
is called before initializing the channel with
dx_initcallp( ), then call progress analysis will operate in basic mode only for that channel.
Call progress analysis allows the application to detect three different types of dial tone, two busy
signals, ringback, and two fax or modem tones on the channel. It is also capable of distinguishing
between a live voice and an answering machine when a call is connected. Parameters for these
capabilities are downloaded to the channel when dx_initcallp( ) is called.
signals, ringback, and two fax or modem tones on the channel. It is also capable of distinguishing
between a live voice and an answering machine when a call is connected. Parameters for these
capabilities are downloaded to the channel when dx_initcallp( ) is called.
The voice driver comes equipped with useful default definitions for each of the signals mentioned
above. The application can change these definitions through the
above. The application can change these definitions through the
, and
functions. The dx_initcallp( ) function takes whatever definitions are currently in
force and uses these definitions to initialize the specified channel.
Once a channel is initialized with the current tone definitions, these definitions cannot be changed
for that channel without deleting all tones (via
for that channel without deleting all tones (via
) and re-initializing with another call
to dx_initcallp( ). dx_deltones( ) also disables call progress analysis. Note, however, that
dx_deltones( ) will erase all user-defined tones from the channel (including any global tone
detection information), and not just the call progress analysis tones.
dx_deltones( ) will erase all user-defined tones from the channel (including any global tone
detection information), and not just the call progress analysis tones.
Name:
int dx_initcallp(chdev)
Inputs:
int chdev
•
valid channel device handle
Returns:
0 if successful
-1 if failure
-1 if failure
Includes:
srllib.h
dxxxlib.h
dxxxlib.h
Category:
Call Progress Analysis
Mode:
synchronous
Platform:
Springware
Parameter
Description
chdev
specifies the valid channel device handle obtained when the channel was opened
using dx_open( )
using dx_open( )