LINEMEDIACONTROLMEDIA

The LINEMEDIACONTROLMEDIA structure describes a media action to be executed when a media mode change is detected. It is used as as entry in an array.

typedef struct linemediacontrolmedia_tag {
    DWORD      dwMediaModes;
    DWORD      dwDuration;
    DWORD      dwMediaControl;
} LINEMEDIACONTROLMEDIA, FAR *LPLINEMEDIACONTROLMEDIA;
 

Members

dwMediaModes
One or more media modes, of type LINEMEDIAMODE_. Values are:
LINEMEDIAMODE_INTERACTIVEVOICE
The presence of voice energy on the call and the call is treated as an interactive call with humans on both ends.
LINEMEDIAMODE_AUTOMATEDVOICE
The presence of voice energy on the call and the voice is locally handled by an automated application.
LINEMEDIAMODE_DATAMODEM
A data modem session on the call.
LINEMEDIAMODE_G3FAX
A group 3 fax is being sent or received over the call.
LINEMEDIAMODE_TDD
A TDD (Telephony Devices for the Deaf) session on the call.
LINEMEDIAMODE_G4FAX
A group 4 fax is being sent or received over the call.
LINEMEDIAMODE_DIGITALDATA
Digital data is being sent or received over the call.
LINEMEDIAMODE_TELETEX
A teletex session on the call. Teletex is one of the telematic services.
LINEMEDIAMODE_VIDEOTEX
A videotex session on the call. Videotex is one the telematic services.
LINEMEDIAMODE_TELEX
A telex session on the call. Telex is one the telematic services.
LINEMEDIAMODE_MIXED
A mixed session on the call. Mixed is one the ISDN telematic services.
LINEMEDIAMODE_ADSI
An ADSI (Analog Display Services Interface) session on the call.
LINEMEDIAMODE_VOICEVIEW
The media mode of the call is VoiceView.
dwDuration
The duration in milliseconds during which the media mode is present before the application is notified or media control action is taken.
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 <media mode(s), duration, media control action>. An array of these triples is passed to the TSPI_lineSetMediaControl function to set media control actions triggered by media mode changes for a given call. When a change to a listed media mode is detected, the corresponding action on the media stream is invoked.

See Also

LINEMEDIACONTROL_ Constants, LINEMEDIAMODE_ Constants, TSPI_lineSetMediaControl