Intel 05-1832-002 User Manual

Page of 564
Voice API for Windows Operating Systems Library Reference — November 2003
133
adjust speed or volume immediately — dx_adjsv( )
dx_adjsv( )
adjust speed or volume immediately
!
!
!
Description
The dx_adjsv( ) function adjusts speed or volume immediately, and for all subsequent plays on a 
specified channel (until changed or cancelled). The speed or the volume can be set to a specific 
value, adjusted incrementally, or can be set to toggle. See the action parameter description for 
information.
The dx_adjsv( ) function uses the speed and volume modification tables to make adjustments to 
play speed or play volume. These tables have 21 entries that represent different levels of speed or 
volume. There are up to ten levels above and below the regular speed or volume. These tables can 
be set with explicit values using 
 or default values can be used. See the Voice API 
Programming Guide for detailed information about these tables.
Notes: 1. This function is similar to dx_setsvcond( ). Use dx_adjsv( ) to explicitly adjust the play 
immediately, and use dx_setsvcond( ) to adjust the play in response to specified conditions. See 
the description of 
 for more information.
2. Whenever a play is started, its speed and volume are based on the most recent modification.
Name:
int dx_adjsv(chdev, tabletype, action, adjsize)
Inputs:
int chdev
valid channel device handle
unsigned short tabletype
type of table to set (speed or volume)
unsigned short action
how to adjust (absolute position, relative change, or toggle)
unsigned short adjsize
adjustment size
Returns:
0 if successful
-1 if failure
Includes:
srllib.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 
tabletype 
specifies whether to modify the playback using a value from the speed or the 
volume modification table 
SV_SPEEDTBL – use the speed modification table
SV_VOLUMETBL – use the volume modification table