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 member 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 member 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.
QuickInfo
Version: Use TAPI version 1.4 and later.
Header: Declared in tapi.h.
See Also
LINEMEDIACONTROLMEDIA, lineSetMediaControl