Voice API for Windows Operating Systems Library Reference — November 2003 155
change the duration definition for a tone — dx_chgdur( )
!
!!
! Cautions
This function changes only the definition of a tone. The new definition does not apply to a channel
until dx_deltones( ) is called on that channel followed by dx_initcallp( ).
!
!!
! Errors
For a list of error codes, see the Error Codes chapter.
!
!!
! Example
#include <stdio.h>
#include <srllib.h>
#include <dxxxlib.h>
#include <windows.h>
main()
{
DX_CAP cap_s;
int ddd, car;
char *chnam, *dialstrg;
chnam = "dxxxB1C1";
dialstrg = "L1234";
/*
* Open channel
*/
if ((ddd = dx_open( chnam, NULL )) == -1 ) {
/* handle error */
}
Parameter Description
tonetype specifies the identifier of the tone whose definition is to be modified. It may be
one of the following:
• TID_BUSY1 – Busy signal
• TID_BUSY2 – Alternate busy signal
• TID_DIAL_INTL – International dial tone
• TID_DIAL_LCL – Local dial tone
• TID_DIAL_XTRA – Special (extra) dial tone
• TID_DISCONNECT – Disconnect tone (post-connect)
• TID_FAX1 – Fax or modem tone
• TID_FAX2 – Alternate fax or modem tone
• TID_RNGBK1 – Ringback (detected as single tone)
• TID_RINGBK2 – Ringback (detected as dual tone)
ontime specifies the length of time that the tone is on (10 msec units)
ondev specifies the maximum permissible deviation from ontime (10 msec units)
offtime specifies the length of time that the tone is off (10 msec units)
offdev specifies the maximum permissible deviation from offtime (10 msec units)