Intel 05-1832-002 User Manual
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.
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.
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.
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.
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
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.