Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 223
return the specified current speed and volume settings — dx_getcursv( )
dx_getcursv( )
return the specified current speed and volume settings
!
!!
! Description
The dx_getcursv( ) function returns the specified current speed and volume settings on a channel.
For example, use dx_getcursv( ) to determine the speed and volume level set interactively by a
listener using DTMF digits during a play. DTMF digits are set as play adjustment conditions using
the dx_setsvcond( ) function, or by one of the convenience functions, dx_addspddig( ) or
dx_addvoldig( ).
!
!!
! 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.
Name: int dx_getcursv(chdev, curvolp, curspeedp)
Inputs: int chdev
• valid channel device handle
int * curvolp
• pointer to current absolute volume setting
int * curspeedp
• pointer to current absolute speed setting
Returns: 0 if success
-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( )
curvolp points to an integer that represents the current absolute volume setting for the
channel. This value will be between -30 dB and +10 dB.
curspeedp points to an integer that represents the current absolute speed setting for the
channel. This value will be between -50% and +50%.