Intel 05-1832-002 User Manual
Voice API for Windows Operating Systems Library Reference — November 2003
401
set conditions that adjust speed or volume of play — dx_setsvcond( )
dx_setsvcond( )
set conditions that adjust speed or volume of play
!
!
!
! Description
The dx_setsvcond( ) function sets adjustments and adjustment conditions for all subsequent plays
on the specified channel (until changed or cancelled).
on the specified channel (until changed or cancelled).
An adjustment is a modification to play speed, play volume, or play (pause/resume) due to an
adjustment condition such as start of play, or the occurrence of an incoming digit during play. This
function uses the specified channel’s Speed or Volume Modification Table. For more information
about these tables, see the Voice API Programming Guide.
adjustment condition such as start of play, or the occurrence of an incoming digit during play. This
function uses the specified channel’s Speed or Volume Modification Table. For more information
about these tables, see the Voice API Programming Guide.
Note:
Calls to dx_setsvcond( ) are cumulative. If adjustment blocks have been set previously, calling this
function adds more adjustment blocks to the list. To replace existing adjustment blocks, clear the
current set of blocks using
function adds more adjustment blocks to the list. To replace existing adjustment blocks, clear the
current set of blocks using
before issuing a dx_setsvcond( ).
The following adjustments and adjustment conditions are defined in the Speed and Volume
Adjustment Condition Blocks structure (
Adjustment Condition Blocks structure (
):
•
which Speed or Volume Modification Table to use (speed or volume)
•
adjustment type (increase/decrease, absolute value, toggle, pause/resume)
•
adjustment conditions (incoming digit, beginning of play)
•
level/edge sensitivity for incoming digits
See
, on page 514, for a full description of the data structure. Up to 20 DX_SVCB
blocks can be specified in the form of an array.
Notes: 1. For speed and volume adjustment, this function is similar to dx_adjsv( ). 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
specified conditions. See the description of
for more information.
2. Whenever the play is started, its speed and volume is based on the most recent modification.
Name:
int dx_setsvcond( chdev, numblk, svcbp)
Inputs:
int chdev
•
valid channel device handle
unsigned short numblk
•
number of DX_SVCB blocks
DX_SVCB * svcbp
•
pointer to array of DX_SVCB structures
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