ATDX_DTNFAIL( )

Description | Cautions | Example

Name:	long ATDX_DTNFAIL(chdev)
Inputs:	int chdev	valid channel device handle
Returns:	code for the dial tone that failed to appear AT_FAILURE if error
Includes:	srllib.h dxxxlib.h
Category:	Extended Attribute

Description

The ATDX_DTNFAIL( ) function returns character for dial tone that PerfectCall Call Analysis failed to detect.

The function parameter is defined as follows:

Parameter	Description
chdev	specifies the valid Dialogic device handle obtained when a board or channel was opened using dx_open( ).

Possible return values are the following:

L	Local dial tone
	International dial tone
X	Special ("extra") dial tone

Cautions

None.

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 */  
   }  
   
   /*  
    *  Delete any previous tones  
    */  
   if ( dx_deltones(ddd) < 0 ) {  
      /* handle error */  
   }  
   
   /*  
    * Now enable Enhanced call progress with above changed settings.  
    */  
   if (dx_initcallp( ddd )) {  
      /* handle error */  
   }  
   
   /*  
    *  Set off Hook  
    */  
   if ((dx_sethook( ddd, DX_OFFHOOK, EV_SYNC )) == -1) {  
      /* handle error */  
   }  
   /*  
    *  Dial  
    */  
   printf("Dialing %s\n", dialstrg );  
   car = dx_dial(ddd,dialstrg,(DX_CAP *)&cap_s,DX_CALLP|EV_SYNC);  
   if (car == -1) {  
      /* handle error */  
   }  
   
   switch( car ) {  
   case CR_NODIALTONE:  
      switch( ATDX_DTNFAIL(ddd) ) {  
      case 'L':  
         printf(" Unable to get Local dial tone\n");  
         break;  
      case 'I':  
         printf(" Unable to get International dial tone\n");  
         break;  
      case 'X':  
         printf(" Unable to get special eXtra dial tone\n");  
         break;  
      }  
      break;  
   
   case CR_BUSY:  
      printf(" %s engaged - %s detected\n", dialstrg,  
        	ATDX_CRTNID(ddd) == TID_BUSY1 ? "Busy 1" : "Busy 2") );  
      break;  
   
   case CR_CNCT:  
      printf(" Successful connection to %s\n", dialstrg );  
      break;  
   
   default:  
      break;  
   }  
   
   /*  
    *  Set on Hook  
    */  
   if ((dx_sethook( ddd, DX_ONHOOK, EV_SYNC )) == -1) {  
      /* handle error */  
   }  
   dx_close( ddd );  
}

Click here to contact Dialogic Customer Engineering