Intel 05-1832-002 User Manual

Page of 564
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_chgdur( ) function alters the standard definition of the duration 
component.
Changing a tone definition has no immediate effect on the behavior of an application. The 
 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 
 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