Intel 05-1832-002 IP Phone User Manual


 
Voice API for Windows Operating Systems Library Reference — November 2003 517
speed and volume modification tables — DX_SVMT
DX_SVMT
speed and volume modification tables
typedef struct DX_SVMT{
char decrease[10]; /* Ten Downward Steps */
char origin; /* Regular Speed or Volume */
char increase[10]; /* Ten Upward Steps */
} DX_SVMT;
!
!!
! Description
The DX_SVMT data structure contains parameters for the speed modification table and volume
modification table.
You can specify the rate of change for speed or volume adjustments by customizing the speed or
volume modification table (SVMT) per channel. The DX_SVMT structure has 21 entries that
represent different levels of speed or volume. This structure is used to set or retrieve the SVMT
values, using dx_setsvmt( ) or dx_getsvmt( ) respectively.
For detailed information on speed and volume modification tables, see the Voice API Programming
Guide.
Note: Although there are 21 entries available in the DX_SVMT structure, all do not have to be utilized
for changing speed or volume; the number of entries can be as small as you require. Ensure that
you insert -128 (80h) in any table entries that do not contain a speed or volume setting.
!
!!
! Field Descriptions
The fields of the DX_SVMT data structure are described as follows:
decrease[10]
Array that provides a maximum of 10 downward steps from the standard (normal) speed or
volume. The size of the steps is specified in this table. Specify the value -128 (80h) in any
entry you are not using. This represents a null-entry and end-of-table marker. Valid values are:
Speed – Percentage decrease from the origin (which is set to 0). Values must be between -
1 and -50.
Volume – Decibel decrease from the origin (which is set to 0). Values must be between -1
and -30.
origin
Specifies the standard play speed or volume. This is the original setting or starting point for
speed and volume control. Set the origin to 0 to assume normal playback speed/volume for the
standard (normal volume is -8 dB).
increase[10]
Array that provides a maximum of 10 upward steps from the standard (normal) speed or
volume. The size of the steps is specified in this table. Specify the value -128 (80h) in any
entry you are not using. This represents a null-entry and end-of-table marker. Valid values are:
Speed – Percentage increase from the origin (which is set to 0). Values must be between 1
and 50.
Volume – Decibel decrease from the origin (which is set to 0). Values must be between 1
and 10.