Filter
Top Products
134 Voice API for Windows Operating Systems Library Reference — November 2003
dx_adjsv( ) — adjust speed or volume immediately
!
!!
! Cautions
None.
!
!!
! Errors
If the function returns -1, use the Standard Runtime Library (SRL) Standard Attribute function
ATDV_LASTERR( ) to obtain the error code or use ATDV_ERRMSGP( ) to obtain a descriptive
error message. One of the following error codes may be returned:
EDX_BADPARM
Invalid parameter
EDX_BADPROD
Function not supported on this board
EDX_SYSTEM
Error from operating system; use dx_fileerrno( ) to obtain error value
action specifies the type of adjustment to make. Set to one of the following:
• SV_ABSPOS – set speed or volume to a specified position in the
appropriate table. (The position is set using the adjsize parameter.)
• SV_RELCURPOS – adjust speed or volume by the number of steps
specified using the adjsize parameter
• SV_TOGGLE – toggle between values specified using the adjsize
parameter
adjsize specifies the size of the adjustment. The adjsize parameter has a different
value depending on how the adjustment type is set using the action parameter.
• If action is SV_ABSPOS, adjsize specifies the position between -10 to +10
in the Speed or Volume Modification Table that contains the required speed
or volume adjustment. The origin (regular speed or volume) has a value of 0
in the table.
• If action is SV_RELCURPOS, adjsize specifies the number of positive or
negative steps in the Speed or Volume Modification Table by which to adjust
the speed or volume. For example, specify -2 to lower the speed or volume
by 2 steps in the Speed or Volume Modification Table.
• If action is SV_TOGGLE, adjsize specifies the values between which speed
or volume will toggle.
SV_CURLASTMOD sets the current speed/volume to the last modified
speed volume level.
SV_CURORIGIN resets the current speed/volume level to the origin (that is,
regular speed/volume).
SV_RESETORIG resets the current speed/volume to the origin and the last
modified speed/volume to the origin.
SV_TOGORIGIN sets the speed/volume to toggle between the origin and
the last modified level of speed/volume.
Parameter Description