ATDX_LONGLOW( )

Description | Cautions | Example | Errors | See Also

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

Description

The ATDX_LONGLOW( ) function returns Call Progress longer 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_SHORTLOW( ) to determine the elements of an established cadence. See the Voice Software Reference: Voice Features Guide for further information.

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

Related to Call Analysis:

• dx_dial( )
• 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