Filter
Top Products
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 dx_setsvmt( ) 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 dx_setsvcond( ) 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 dx_open( )
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