Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 399
specify the template of the cadenced tone — dx_SetRecordNotifyBeepTone( )
dx_SetRecordNotifyBeepTone( )
specify the template of the cadenced tone
!
!!
! Description
The dx_SetRecordNotifyBeepTone( ) function specifies the template of the cadenced tone to be
used as the record notification beep tone during subsequent calls to the Voice record functions. This
function overwrites the default template used on DM3 boards. If no template is specified, the
default beep tone has these specifications: 1400 Hz, -18 dB, 420 msecs on, 15 secs off.
The RM_NOTIFY flag in the mode parameter of various Voice record functions is used to instruct
these functions to generate a record notification beep tone.
Note: The amplitude for the beep tone specified in the TN_GEN structure is reduced by 9 dB due to the
high impedance telephone interface. Therefore, if you require an amplitude of -18 dB, you must
specify the value of -9 dB in the TN_GEN structure. It is not recommended that you specify a value
higher than -8 dB (such as -7 dB or -6 dB) as this can produce a distorted beep tone on the line.
!
!!
! Cautions
None.
Name: int dx_SetRecordNotifyBeepTone(chdev, tngencadp)
Inputs: int chdev
• voice channel device handle
const TN_GENCAD *tngencadp
• pointer to the cadenced tone generation data structure
Returns: 0 if success
-1 if failure
Includes: srllib.h
dxxxlib.h
Category: configuration
Mode: synchronous
Platform: DM3
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was
opened using dx_open( )
tngencadp points to a TN_GENCAD structure which contains parameters for the
cadenced tone generation template. This structure in turn uses the
TN_GEN structure which specifies single-frequency or dual-frequency
tone definitions.