Filter
Top Products
514 Voice API for Windows Operating Systems Library Reference — November 2003
DX_SVCB — speed and volume adjustment condition block
DX_SVCB
speed and volume adjustment condition block
typedef struct DX_SVCB {
unsigned short type; /* Bit Mask */
short adjsize; /* Adjustment Size */
unsigned char digit; /* ASCII digit value that causes the action */
unsigned char digtype; /* Digit Type (e.g., 0 = DTMF) */
} DX_SVCB;
!
!!
! Description
The DX_SVCB data structure contains parameters for the speed and volume adjustment condition
block.
This structure is used by dx_setsvcond( ) function to specify a play adjustment condition that is
added to the internal speed and volume condition table (SVCT). The play adjustment conditions in
the SVCT are used to adjust speed or volume automatically at the beginning of playback or in
response to digits entered by the user during playback.
The dx_setsvcond( ), dx_addspddig( ), and dx_addvoldig( ) functions can be used to add play
adjustment conditions to the SVCT. These functions tie a speed or volume adjustment to an
external event, such as a DTMF digit.
You cannot change an existing speed or volume adjustment condition in the SVCT without using
the dx_clrsvcond( ) function to clear the SVCT of all conditions and then adding a new set of
adjustment conditions to the SVCT.
This structure is used to specify the following:
• table type (speed modification table, volume modification table)
• adjustment type (step, index, toggle, pause/resume play)
• adjustment size or action
• adjustment condition (incoming digit, beginning of play)
• level/edge sensitivity for incoming digits
For more information on speed and volume modification tables as well as the pause and resume
play feature, see the Voice API Programming Guide.
!
!!
! Field Descriptions
The fields of the DX_SVCB data structure are described as follows:
type
Type of Playback Adjustment: specifies an OR combination of the following:
Adjustment Table Type (required): specifies one adjustment type, either speed or volume
• SV_SPEEDTBL – selects speed table to be modified
• SV_VOLUMETBL – selects volume table to be modified
Adjustment Method (required except for pause/resume play): specifies one adjustment
method (step, index, or toggle), which also determines how the adjsize value is used