dx_blddt( )

Description | Cautions | Example | Errors | See Also

Name:	int dx_blddt(tid,freq1,fq1dev,freq2,fq2dev,mode)
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 mode	leading or trailing edge
Returns:	0 if success
	-1 if failure
Includes:	srllib.h dxxxlib.h
Category:	Global Tone Detection

Description

The dx_blddt( ) function defines a user-defined dual-frequency tone. Subsequent calls to dx_addtone( ) will enable detection of this tone, until another tone is defined.

Issuing a dx_blddt( ) defines a new tone but dx_addtone( ) must be used to add the tone to the channel.

Use dx_addtone( ) to enable detection of the tone on a channel.

Parameter	Description
tid	specifies a unique identifier for the tone.
	NOTE: Do not use tone IDs 261, 262 and 263, they are reserved for library use. If you are using R2MF tone detection, reserve the use of tone IDs 101 to 115 for the R2MF tones. See r2_creatfsig( ) for further information.
freq1	specifies the first frequency (in Hz) for the tone
frq1dev	specifies the allowable deviation for the first frequency (in Hz).
freq2	specifies the second frequency (in Hz) for the tone
frq2dev	specifies the allowable deviation for the second frequency (in Hz)
mode	specifies whether tone detection notification will occur on the leading or trailing edge of the tone. Set to one of the following:
	TN_LEADING
	TN_TRAILING

Cautions

1. Only one tone per process can be defined at any time. Ensure that dx_blddt( ) is called for each dx_addtone( ). The tone is not created until dx_addtone( ) is called, and a second consecutive call to dx_blddt( ) will replace the previous tone definition for the channel. If you call dx_addtone( ) without calling dx_blddt( ) an error will occur.
2. Do not use tone IDs 261, 262 and 263, they are reserved for library use.
3. If you are using R2MF tone detection, reserve the use of tone IDs 101 to 115 for the R2MF tones. See r2_creatfsig( ) for further information.
4. When using this function in a multi-threaded application, use critical sections or a semaphore around the function call to ensure a thread-safe application. Failure to do so will result in "Bad Tone Template ID" errors.

Example

#include <stdio.h>  
#include <srllib.h>  
#include <dxxxlib.h>  
#include <windows.h>  
   
#define TID_1   101  
main()  
{  
   int  dxxxdev;  
   /*  
    * Open the Voice Channel Device and Enable a Handler  
    */  
   if ( ( dxxxdev = dx_open( "dxxxB1C1", NULL) ) == -1 ) {  
      perror( "dxxxB1C1" );  
      exit( 1 );  
   }  
   
   /*  
    * Describe a Simple Dual Tone Frequency Tone of 950-  
    * 1050 Hz and 475-525 Hz using leading edge detection.  
    */  
   if ( dx_blddt( TID_1, 1000, 50, 500, 25, TN_LEADING ) == -1 ) {  
      printf( "Unable to build a Dual Tone Template\n" );  
   }  
   
   /*  
    * Continue Processing  
    *   .  
    *   .  
    *   .  
    */  
   
   /*  
    * Close the opened Voice Channel Device  
    */  
   if ( dx_close( dxxxdev ) != 0 ) {  
      perror( "close" );  
   }  
   
   /* Terminate the Program */  
   exit( 0 );  
}

Errors

None.

See Also

Global Tone Detection:

• Global Tone Detection (Voice Software Reference: Voice Features Guide)

Building Tones:

• dx_bldst( )
• dx_blddtcad( )
• dx_bldstcad( )

Enabling Tone Detection:

• dx_addtone( )
• dx_distone( )
• dx_enbtone( )

R2MF Tones:

• r2_creatfsig( )
• r2_playbsig( )

Click here to contact Dialogic Customer Engineering