LINEMEDIACONTROLMEDIA
The LINEMEDIACONTROLMEDIA structure describes a media action to be executed when detecting a media mode change. It is used as an entry in an array.
typedef struct linemediacontrolmedia_tag {
DWORD dwMediaModes;
DWORD dwDuration;
DWORD dwMediaControl;
} LINEMEDIACONTROLMEDIA, FAR *LPLINEMEDIACONTROLMEDIA;
Members
-
dwMediaModes
-
One or more media modes. This member uses the following LINEMEDIAMODE_ constants:
-
LINEMEDIAMODE_UNKNOWN
-
A media stream exists but its mode is not known. This would correspond to a call with an unclassified media type. In typical analog telephony environments, an incoming call's media mode may be unknown until after the call has been answered and the media stream filtered to make a determination.
-
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_G4FAX
-
A group 4 fax is being sent or received over the call.
-
LINEMEDIAMODE_TDD
-
A TDD (Telephony Devices for the Deaf) session on 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 of the telematic services.
-
LINEMEDIAMODE_TELEX
-
A telex session on the call. Telex is one of the telematic services.
-
LINEMEDIAMODE_MIXED
-
A mixed session on the call. Mixed is one of 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 should be present before the application should be notified or media control action should be taken.
-
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 <media mode(s), duration, media-control action>. An array of these triples is passed to the lineSetMediaControl function to set the media control actions triggered by media mode changes for a given call. When a change to a listed media mode 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
lineSetMediaControl