Intel 05-1832-002 IP Phone User Manual


 
154 Voice API for Windows Operating Systems Library Reference — November 2003
dx_chgdur( ) — change the duration definition for a tone
dx_chgdur( )
change the duration definition for a tone
!
!!
! Description
The dx_chgdur( ) function changes the standard duration definition for a call progress analysis
tone, identified by tonetype. The voice driver comes with default definitions for each of the call
progress analysis tones. The dx_c hgdur( ) function alters the standard definition of the duration
component.
Changing a tone definition has no immediate effect on the behavior of an application. The
dx_initcallp( ) function takes the tone definitions and uses them to initialize a channel. Once a
channel is initialized, subsequent changes to the tone definitions have no effect on that channel. For
these changes to take effect, you must first call dx_deltones( ) followed by dx_initcallp( ).
For more information on default tone templates as well as the call progress analysis feature, see the
Voice API Programming Guide.
Name: int dx_chgdur(tonetype, ontime, ondev, offtime, offdev)
Inputs: int tonetype
tone to modify
int ontime
on duration
int ondev
ontime deviation
int offtime
off duration
int offdev
offtime deviation
Returns: 0 on success
-1 if tone does not have cadence values
-2 if unknown tone type
Includes: srllib.h
dxxxlib.h
Category: Call Progress Analysis
Mode: synchronous
Platform: Springware