Intel 05-1832-002 IP Phone User Manual


 
Voice API for Windows Operating Systems Library Reference — November 2003 335
get tone information for a specific call progress tone — dx_querytone( )
!
!!
! Errors
If this function returns -1 to indicate failure, use ATDV_LASTERR( ) and ATDV_ERRMSGP( )
to retrieve one of the following error reasons:
EDX_BADPARM
invalid parameter
EDX_SYSTEM
error from operating system
EDX_TONEID
bad tone template ID
!
!!
! Example
#include "srllib.h"
#include "dxxxlib.h"
main()
{
int brdhdl; /* board handle */
.
.
.
/* Open board */
if ((brdhdl = dx_open("brdB1",0)) == -1)
{
printf("Cannot open board\n");
/* Perform system error processing */
exit(1);
}
/* Get the tone information for the TID_BUSY1 Tone*/
int result;
TONE_DATA tonedata;
if ((result =
dx_querytone(brdhdl, TID_BUSY1, &tonedata, EV_SYNC)
) == -1)
{
printf("Cannot obtain tone information for TID_BUSY1 \n");
/* Perform system error processing */
exit(1);
}
}
!
!!
! See Also
dx_deletetone( )
dx_createtone( )