Filter
Top Products
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 DM3 boards, call progress analysis is enabled directly through the dx_dial( ) function.
On Springware boards, to use call progress analysis, dx_initcallp( ) must be called prior to using
dx_dial( ) on the specified channel. If dx_dial( ) 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.
The voice driver comes equipped with useful default definitions for each of the signals mentioned
above. The application can change these definitions through the dx_chgdur( ), dx_chgfreq( ), and
dx_chgrepcnt( ) 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 dx_deltones( )) 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.
Name: int dx_initcallp(chdev)
Inputs: int chdev
• valid channel device handle
Returns: 0 if successful
-1 if failure
Includes: srllib.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( )