Filter
Top Products
158 Voice API for Windows Operating Systems Library Reference — November 2003
dx_chgfreq( ) — change the frequency definition for a tone
dx_chgfreq( )
change the frequency definition for a tone
!
!!
! Description
The dx_chgfreq( ) function changes the standard frequency 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_chgfreq( ) function alters the standard definition of the frequency
component.
Call progress analysis supports both single-frequency and dual-frequency tones. For dual-
frequency tones, the frequency and tolerance of each component may be specified independently.
For single-frequency tones, specifications for the second frequency are set to zero.
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_chgfreq(tonetype, freq1, freq1dev, freq2, freq2dev)
Inputs: int tonetype
• tone to modify
int freq1
• frequency of first tone
int freq1dev
• frequency deviation for first tone
int freq2
• frequency of second tone
int freq2dev
• frequency deviation of second tone
Returns: 0 on success
-1 on failure due to bad parameter(s) for tone type
-2 on failure due to unknown tone type
Includes: srllib.h
dxxxlib.h
Category: Call Progress Analysis
Mode: synchronous
Platform: Springware