Intel 05-1832-002 User Manual

Page of 564
Voice API for Windows Operating Systems Library Reference — November 2003
81
return the duration of the first SIT sequence — ATDX_FRQDUR( )
ATDX_FRQDUR( )
return the duration of the first SIT sequence
!
!
!
Description
The ATDX_FRQDUR( ) function returns the duration of the first Special Information Tone (SIT) 
sequence in 10 msec units after 
 terminated due to an Operator Intercept. 
Termination due to Operator Intercept is indicated by 
 returning CR_CEPT. 
For information on SIT frequency detection, see the Voice API Programming Guide.
!
!
!
Cautions
None.
!
!
!
Errors
This function fails and returns AT_FAILURE if an invalid channel device handle is specified.
!
!
!
Example
This example illustrates ATDX_FRQDUR( )
, and 
/* Call progress analysis with user-specified parameters */
#include <stdio.h>
#include <srllib.h>
#include <dxxxlib.h>
main()
{
   int cares, chdev;
   DX_CAP capp;
   .
   .
Name:
long ATDX_FRQDUR(chdev)
Inputs:
int chdev
valid channel device handle
Returns:
first frequency duration in 10 msec units if success
AT_FAILURE if error
Includes:
srllib.h
dxxxlib.h
Category:
Extended Attribute
Mode:
synchronous
Platform:
Springware 
Parameter
Description
chdev 
specifies the valid channel device handle obtained when the channel was opened 
using dx_open( )