Filter
Top Products
406 Voice API for Windows Operating Systems Library Reference — November 2003
dx_setsvmt( ) — change default values of the speed or volume modification table
!
!!
! Cautions
On DM3 boards, if you close a device via dx_close( ) after modifying speed and volume table
values using dx_setsvmt( ), the dx_getcursv( ) function may return incorrect speed and volume
settings for the device. This is because the next dx_open( ) resets the speed and volume tables to
their default values. Therefore, it is recommended that you do not issue a dx_close( ) during a call
where you have modified speed and volume table values.
!
!!
! 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_NONZEROSIZE
Reset to default was requested but size was non-zero
EDX_SPDVOL
Neither SV_SPEEDTBL nor SV_VOLUMETBL was specified
EDX_SVMTRANGE
An entry in DX_SVMT was out of range
EDX_SVMTSIZE
Invalid table size specified
EDX_SYSTEM
Error from operating system; use dx_fileerrno( ) to obtain error value
svmtp points to the DX_SVMT structure whose contents are used to update either
the speed or volume modification table
This structure is not used when SV_SETDEFAULT has been set in the flag
parameter.
flag Specifies one of the following:
• SV_SETDEFAULT – reset the table to its default values. See the Voice API
Programming Guide for a list of default values.
In this case, the DX_SVMT pointed to by svmtp is ignored.
• SV_WRAPMOD – wrap around the speed or volume adjustments that
occur at the top or bottom of the speed or volume modification table.
Note: Set flag to 0 if you do not want to use either SV_WRAPMOD or
SV_SETDEFAULT.
Parameter Description