Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 93
return percentage of time SIT tone was out of bounds — ATDX_FRQOUT( )
ATDX_FRQOUT( )
return percentage of time SIT tone was out of bounds
!
!!
! Description
The ATDX_FRQOUT( ) function returns percentage of time SIT tone was out of bounds as
specified by the range in the DX_CAP structure.
Upon detection of a frequency within the range specified in the DX_CAP structure ca_upperfrq
and lower ca_lowerfrq, use this function to optimize the ca_rejctfrq parameter (which sets the
percentage of time that the frequency can be out of bounds).
For information on SIT frequency detection, see the Voice API Programming Guide.
!
!!
! Cautions
This function is only for use with non-DSP boards. If you call it on a DSP board, it will return zero.
!
!!
! Errors
This function will fail and return AT_FAILURE if an invalid channel device handle is specified in
chdev.
!
!!
! Example
/* Call progress analysis with user-specified parameters */
#include <stdio.h>
#include <srllib.h>
#include <dxxxlib.h>
Name: long ATDX_FRQOUT(chdev)
Inputs: int chdev
• valid channel device handle
Returns: percentage frequency out-of bounds
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( )