ATDX_SHORTLOW( )

Description | Cautions | Example | Errors | See Also

Name:	long ATDX_SHORTLOW(chdev)
Inputs:	int chdev	valid Dialogic channel device handle
Returns:	duration of shorter silence if successful AT_FAILURE if error
Includes:	srllib.h dxxxlib.h
Category:	Extended Attribute

Description

The ATDX_SHORTLOW( ) function returns Call Progress shorter silence duration in 10 ms units for the initial signal that occurred during Call Analysis on the channel chdev. This function can be used in conjunction with ATDX_SIZEHI( ) and ATDX_LONGLOW( ) to determine the elements of an established cadence. See the Voice Software Reference: Voice Features Guide for further information.

Compare the results of this function with the DX_CAP field ca_lo2rmin to determine whether the cadence is a double or single ring.

If the result of ATDX_SHORTLOW( ) is less than the ca_lo2rmin field this indicates a double ring cadence.

If the result of ATDX_SHORTLOW( ) is greater than the ca_lo2rmin field this indicates a single ring.

The function parameter is defined as follows:

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

Cautions

None.

Example

/* Call Analysis with user-specified parameters */  
#include <stdio.h>  
#include <srllib.h>  
#include <dxxxlib.h>  
#include <windows.h>  
   
main()  
{  
   int cares, chdev;  
   DX_CAP capp;  
   .  
   .  
   /* open the channel using dx_open( ).  Obtain channel device descriptor  
    * in chdev  
    */  
   if ((chdev = dx_open("dxxxB1C1",NULL)) == -1)  {  
     /* process error */  
   }  
   
   /* take the phone off-hook */  
   if (dx_sethook(chdev,DX_OFFHOOK,EV_SYNC) == -1) {  
     /* process error */  
   }  
   
   /* Set the DX_CAP structure as needed for call analysis. Perform the  
    * outbound dial with call analysis enabled  
    */  
   if ((cares = dx_dial(chdev,"5551212",&capp,DX_CALLP|EV_SYNC)) == -1) {  
     /* perform error routine */  
   }  
   switch (cares) {  
     case CR_CNCT:	/* Call Connected, get some additional info */  
      printf("\nDuration of short low - %ld ms",ATDX_SHORTLOW(chdev)*10);  
      printf("\nDuration of long low  - %ld ms",ATDX_LONGLOW(chdev)*10);  
      printf("\nDuration of answer    - %ld ms",ATDX_ANSRSIZ(chdev)*10);  
      break;  
     case CR_CEPT:     /* Operator Intercept detected */  
      printf("\nFrequency detected - %ld Hz",ATDX_FRQHZ(chdev));  
      printf("\n%% of Frequency out of bounds - %ld Hz",ATDX_FRQOUT(chdev));  
      break;  
     case CR_BUSY:  
      .  
      .  
   }  
   
}

Errors

This function will fail and return AT_FAILURE if an invalid channel device handle is specified in chdev.

See Also

• dx_dial( )
• ATDX_LONGLOW( )
• ATDX_SIZEHI( )
• ATDX_CPTERM( )
• DX_CAP structure
• Call Analysis (Voice Software Reference: Voice Features Guide)
• "Cadence Detection" (Voice Software Reference: Voice Features Guide)

Click here to contact Dialogic Customer Engineering