Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 87
return the frequency of the first SIT sequence — ATDX_FRQHZ( )
ATDX_FRQHZ( )
return the frequency of the first SIT sequence
!
!!
! Description
The ATDX_FRQHZ( ) function returns the frequency in Hz of the first Special Information Tone
(SIT) sequence after dx_dial( )has terminated due to an Operator Intercept.
Termination due to Operator Intercept is indicated by ATDX_CPTERM( ) 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 the use of ATDX_FRQHZ( ), ATDX_FRQHZ2( ), and
ATDX_FRQHZ3( ).
/* 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_FRQHZ(chdev)
Inputs: int chdev
• valid channel device handle
Returns: first tone frequency in Hz 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( )