Intel 05-1832-002 User Manual

Page of 564
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 
 structure 
contains the relevant tone information. 
Prior to creating a new tone definition with dx_createtone( ), us
 to get tone 
information for that tone, then us
 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