LINEMEDIACONTROLDIGIT

The LINEMEDIACONTROLDIGIT structure describes a media action to be executed when detecting a digit. It is used as as 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 modes that are to be monitored, of type LINEDIGITMODE_. Values are:
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, of type LINEMEDIACONTROL_. Values are:
LINEMEDIACONTROL_NONE
Make no change to the media stream.
LINEMEDIACONTROL_START
Start the media stream.
LINEMEDIACONTROL_RESET
Reset the media stream. Provide the effect of 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

Not extensible.

The LINEMEDIACONTROLMEDIA structure defines a triple <digit, digit mode(s), media control action>. An array of these triples is passed to the TSPI_lineSetMediaControl function to set media control actions triggered by digits detected on a given call. When a listed digit is detected, the corresponding action on the media stream is invoked.

See Also

LINEDIGITMODE_ Constants, LINEMEDIACONTROL_ Constants, TSPI_lineSetMediaControl