ATDX_SIZEHI( )

Description | Cautions | Example | Errors | See Also

Name:	long ATDX_SIZEHI(chdev)
Inputs:	int chdev	valid Dialogic channel device handle
Returns:	non-silence duration in 10 ms units if successful AT_FAILURE if error
Includes:	srllib.h dxxxlib.h
Category:	Extended Attribute

Description

The ATDX_SIZEHI( ) function returns Call Progress initial non-silence duration in 10 ms units 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.

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 non-silence  - %ld ms",ATDX_SIZEHI(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_SHORTLOW( )
• 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