Intel 05-1832-002 User Manual
Voice API for Windows Operating Systems Library Reference — November 2003
405
change default values of the speed or volume modification table — dx_setsvmt( )
dx_setsvmt( )
change default values of the speed or volume modification table
!
!
!
! Description
The dx_setsvmt( ) function updates the speed or volume modification table for a channel using the
values contained in a specified
values contained in a specified
structure.
This function can modify the speed or volume modification table so that the following occurs:
•
When speed or volume adjustments reach their highest or lowest value, wrap the next
adjustment to the extreme opposite value. For example, if volume reaches a maximum level
during a play, the next adjustment would modify the volume to its minimum level.
adjustment to the extreme opposite value. For example, if volume reaches a maximum level
during a play, the next adjustment would modify the volume to its minimum level.
•
Reset the speed or volume modification table to its default values. Defaults are listed in the
Voice API Programming Guide.
Voice API Programming Guide.
and see also the Voice API Programming Guide.
Name:
int dx_setsvmt(chdev, tabletype, svmtp, flag)
Inputs:
int chdev
•
valid channel device handle
unsigned short tabletype
•
type of table to update (speed or volume)
DX_SVMT * svmtp
•
pointer to speed or volume modification table to modify
unsigned short flag
•
optional modification flag
Returns:
0 if success
-1 if failure
-1 if failure
Includes:
srllib.h
dxxxlib.h
dxxxlib.h
Category:
Speed and Volume
Mode:
synchronous
Platform:
DM3, Springware
Parameter
Description
chdev
specifies the valid channel device handle obtained when the channel was
opened using
opened using
tabletype
specifies whether to update the speed modification table or the volume
modification table:
modification table:
•
SV_SPEEDTBL – update the speed modification table values
•
SV_VOLUMETBL – update the volume modification table values