Voice API for Windows Operating Systems Library Reference — November 2003 139
define a user-defined dual frequency cadenced tone — dx_blddtcad( )
dx_blddtcad( )define a user-defined dual frequency cadenced tone
!
!!
!Description
The dx_blddtcad( ) function defines a user-defined dual frequency cadenced tone. Subsequent
calls to dx_addtone( ) will use this tone, until another tone is defined. A dual frequency cadence
tone has dual frequency signals with specific on/off characteristics.
Issuing dx_blddtcad( ) defines a new tone. You must use dx_addtone( ) to add the tone to the
channel and enable its detection.
For more information about global tone detection, see the Voice API Programming Guide.
Name: int dx_blddtcad(tid, freq1, fq1dev, freq2, fq2dev, ontime, ontdev, offtime, offtdev, repcnt)
Inputs: unsigned int tid •tone ID to assign
unsigned int freq1 •frequency 1 in Hz
unsigned int fq1dev •frequency 1 deviation in Hz
unsigned int freq2 •frequency 2 in Hz
unsigned int fq2dev •frequency 2 deviation in Hz
unsigned int ontime •tone-on time in 10 msec
unsigned int ontdev •tone-on time deviation in 10 msec
unsigned int offtime •tone-off time in 10 msec
unsigned int offtdev •tone-off time deviation in 10 msec
unsigned int repcnt •number of repetitions if cadence
Returns: 0 if success
-1 if failure
Includes: srllib.h
dxxxlib.h
Category: Global Tone Detection
Mode: synchronous
Platform: DM3, Springware
Parameter Description
tid specifies a unique identifier for the tone. See Cautions for more information on
the tone ID.
freq1 specifies the first frequency (in Hz) for the tone
frq1dev specifies the allowable deviation (in Hz) for the first frequency
freq2 specifies the second frequency (in Hz) for the tone
frq2dev specifies the allowable deviation (in Hz) for the second frequency