Voice API for Windows Operating Systems Library Reference — November 2003 409
change the duration of the built-in beep tone — dx_settonelen( )
dx_settonelen( )change the duration of the built-in beep tone
!
!!
!Description
The dx_settonelen( ) function changes the duration of the built-in beep tone (sometimes referred to
as a pre-record beep), which some application programs make use of to indicate the start of a
recording or playback.
When a record or playback function specifies RM_TONE or PM_TONE (respectively) in the mode
parameter, a beep tone will be transmitted immediately before the record or play is initiated. The
duration of the beep tone can be altered by this function.
A device handle is not used when calling dx_settonelen( ). The beep tone will be modified for all
voice resources used in the current process. The beep tone will not be affected in other processes.
!
!!
!Cautions
When using this function in a multi-threaded application, use critical sections or a semaphore
around the function call to ensure a thread-safe application. Failure to do so will result in “Bad
Tone Template ID” errors.
!
!!
!Errors
None.
Name: int dx_settonelen(tonelength)
Inputs: int tonelength •tone duration
Returns: 0 if successful
Includes: srllib.h
dxxxlib.h
Category: Configuration
Mode: synchronous
Platform: Springware
Parameter Description
tonelength specifies the duration of the tone in 200 ms units.
Default: 1 (200 ms). Range: 1 - 65535.