LINEMEDIACONTROLDIGIT
The LINEMEDIACONTROLDIGIT
structure describes a media action to be executed when detecting a digit. It is
used as an entry in an array.
typedef struct linemediacontroldigit_tag {
DWORD dwDigit;
DWORD dwDigitModes;
DWORD dwMediaControl;
} LINEMEDIACONTROLDIGIT, FAR
*LPLINEMEDIACONTROLDIGIT;
Members
dwDigit
The low-order
byte of this DWORD specifies the digit in ASCII whose detection is to trigger a
media action. Valid digits depend on the media mode.
dwDigitModes
The digit
mode(s) that are to be monitored. This field uses the following LINEDIGITMODE_
constants:
LINEDIGITMODE_PULSE
Detect digits
as audible clicks that are the result of rotary pulse sequences. Valid digits
for pulse are '0' through '9'.
LINEDIGITMODE_DTMF
Detect digits
as DTMF tones. Valid digits for DTMF are '0' through '9', 'A', 'B', 'C', 'D',
'*', and '#'.
LINEDIGITMODE_DTMFEND
Detect and
provide application notification of DTMF down edges. Valid digits for DTMF are
'0' through '9', 'A', 'B', 'C', 'D', '*', and '#'.
dwMediaControl
The
media-control action. This field uses the following LINEMEDIACONTROL_ constants:
LINEMEDIACONTROL_NONE
No change is
to be made to the media stream.
LINEMEDIACONTROL_RESET
Reset the
media stream. Equivalent to an end-of-input. All buffers are released.
LINEMEDIACONTROL_PAUSE
Temporarily
pause the media stream.
LINEMEDIACONTROL_RESUME
Start or
resume a paused media stream.
LINEMEDIACONTROL_RATEUP
The speed of
the media stream is increased by some stream-defined quantity.
LINEMEDIACONTROL_RATEDOWN
The speed of
the media stream is decreased by some stream-defined quantity.
LINEMEDIACONTROL_RATENORMAL
The speed of
the media stream is returned to normal.
LINEMEDIACONTROL_VOLUMEUP
The amplitude
of the media stream is increased by some stream-defined quantity.
LINEMEDIACONTROL_VOLUMEDOWN
The amplitude
of the media stream is decreased by some stream-defined quantity.
LINEMEDIACONTROL_VOLUMENORMAL
The amplitude
of the media stream is returned to normal.
Remarks
No
extensions.
The LINEMEDIACONTROLMEDIA
structure defines a triple <digit, digit mode(s), media-control action>.
An array of these triples is passed to the lineSetMediaControl function
to set the media-control actions triggered by digits detected on a given call.
When a listed digit is detected, then the corresponding action on the media
stream is invoked.
See Also