Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 333
get tone information for a specific call progress tone — dx_querytone( )
dx_querytone( )
get tone information for a specific call progress tone
!
!!
! Description
The dx_querytone( ) function returns tone information for a call progress tone currently available
on the physical board device. On successful completion of the function, the TONE_DATA structure
contains the relevant tone information.
Prior to creating a new tone definition with dx_createtone( ), use dx_querytone( ) to get tone
information for that tone, then use dx_deletetone( ) to delete that tone.
Name: int dx_querytone(brdhdl, toneid, tonedata, mode)
Inputs: int brdhdl
• a valid physical board level device
int toneid
• tone ID of the call progress tone
TONE_DATA *tonedata
• pointer to the TONE_DATA structure
unsigned short mode
• mode
Returns: 0 if successful
-1 if failure
Includes: srllib.h
dxxxlib.h
Category: Call Progress Analysis
Mode: asynchronous or synchronous
Platform: DM3