Intel 05-1832-002 IP Phone User Manual


 
382 Voice API for Windows Operating Systems Library Reference — November 2003
dx_setgtdamp( ) — set up the tone detection amplitudes
dx_setgtdamp( )
set up the tone detection amplitudes
!
!!
! Description
The dx_setgtdamp( ) function sets up the amplitudes to be used by the general tone detection. This
function must be called before calling dx_blddt( ), dx_blddtcad( ), dx_bldst( ), or dx_bldstcad( )
followed by dx_addtone( ). Once called, the values set will take effect for all dx_blddt( ),
dx_blddtcad( ), dx_bldst( ), and dx_bldstcad( ) function calls.
If this function is not called, then the MINERG firmware parameters that were downloaded remain
at the following settings: -42 dBm for minimum amplitude and 0 dBm for maximum amplitude.
!
!!
! Cautions
If this function is called, then the amplitudes set will take effect for all tones added afterwards.
To reset the amplitudes back to the defaults, call this function with the defines GT_MIN_DEF
and GT_MAX_DEF for minimum and maximum defaults.
Name: void dx_setgtdamp(gtd_minampl1, gtd_maxampl1, gtd_minampl2, gtd_maxampl2)
Inputs: short int gtd_minampl1
minimum amplitude of the first frequency
short int gtd_maxampl1
maximum amplitude of the first frequency
short int gtd_minampl2
minimum amplitude of the second frequency
short int gtd_maxampl2
maximum amplitude of the second frequency
Returns: void
Includes: srllib.h
dxxxlib.h
Category: Global Tone Detection
Mode: synchronous
Platform: DM3, Springware
Parameter Description
gtd_minampl1 specifies the minimum amplitude of tone 1, in dB
gtd_maxampl1 specifies the maximum amplitude of tone 1, in dB
gtd_minampl2 specifies the minimum amplitude of tone 2, in dB
gtd_maxampl2 specifies the maximum amplitude of tone 2, in dB
Default Value Description
GT_MIN_DEF Default value in dB for minimum GTD amplitude that can be entered for
gtd_minampl* parameters.
GT_MAX_DEF Default value in dB for maximum GTD amplitude that can be entered for
gtd_maxampl* parameters.