Intel 05-1832-002 User Manual
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
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
function, or by one of the convenience functions,
or
!
!
!
! Cautions
On DM3 boards, if you close a device via
after modifying speed and volume table
values using
, the dx_getcursv( ) function may return incorrect speed and volume
settings for the device. This is because the next
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
-1 if failure
Includes:
srllib.h
dxxxlib.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
opened using
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.
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%.
channel. This value will be between -50% and +50%.