Filter
Top Products
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).
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.
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 dx_clrsvcond( ) before issuing a dx_setsvcond( ).
The following adjustments and adjustment conditions are defined in the Speed and Volume
Adjustment Condition Blocks structure (DX_SVCB):
• 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 DX_SVCB, 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 dx_adjsv( ) 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
Includes: srllib.h
dxxxlib.h
Category: Speed and Volume
Mode: synchronous
Platform: DM3, Springware