ThbTapiLine.MediaModes
Unit: hbTapi
 

This is a set of bit flags that indicate the media modes that will be used when the TAPI line device is activated by setting the ThbTapiLine.Active property to True. This value is used to register the application as a potential target for incoming calls of the specified media modes.

The MediaModes property is meaningfull only if the ThbTapiLine.Privileges.Owner property is set to True.

When ThbTapiLine.DeviceID/DeviceName property is modified, the ThbTapiLine.Caps.MediaModes property is set to the value of all media modes the line device supports. This value can be used to check the capabilities of the line device. If the ThbTapiLine.MediaModes is equal to zero when ThbTapiLine.Active is set to True, the line device will be opened using all mdeia modes it supports. If MediaModes is not equal to zero, the device will be opened using the media modes defined in this property.

If your application requires fewer media modes than the default, you are able to change the value of this property prior to setting ThbTapiLine.Active to True, otherwise you should set MediaMode to zero.

The LINEMEDIAMODE_ constants describe media types (or modes) of a communications session or call. Possible media modes are:

Constant

Description

LINEMEDIAMODE_AUTOMATEDVOICE

Voice energy was detected on the call, and the voice is locally handled by an automated application such as with an answering machine application. When a service provider cannot distinguish between interactive and automated voice on an incoming call, it will report the call as interactive voice.

LINEMEDIAMODE_DATAMODEM

A data modem session on the call.

LINEMEDIAMODE_ADSI

An ADSI (Analog Display Services Interface) session on the call. ADSI enhances voice calls with alphanumeric information downloaded to the phone and the use of soft buttons on the phone.

LINEMEDIAMODE_DIGITALDATA

A digital data stream of unspecified format.

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_INTERACTIVEVOICE

Voice energy was detected on the call, and the call is handled as an interactive voice call with humans on both ends.

LINEMEDIAMODE_MIXED

A mixed session on the call. Mixed is one of the ISDN telematic services.

LINEMEDIAMODE_TDD

A TDD (Telephony Devices for the Deaf) session on the call.

LINEMEDIAMODE_TELETEX

A teletex session on the call. Teletex is one of the telematic services.

LINEMEDIAMODE_TELEX

A telex session on the call. Telex is one of the telematic services.

LINEMEDIAMODE_VIDEO

The media type of the call is video. (TAPI versions 2.1 and later)

LINEMEDIAMODE_VIDEOTEX

A videotex session on the call. Videotex is one the telematic services.

LINEMEDIAMODE_VOICEVIEW

The media type of the call is VoiceView. (TAPI versions 1.4 and later)

LINEMEDIAMODE_UNKNOWN

A media stream exists but its mode is not currently known and may become known later. This would correspond to a call with an unclassified media type. In typical analog telephony environments, an incoming call's media type may be unknown until after the call has been answered and the media stream has been filtered to make a determination.
If the unknown media-mode flag is set, other media flags can also be set. This is used to signify that the media is unknown but that it is likely to be one of the other selected media types.

Availability

Design-Time: Read, Write / Run-Time: Read, Write

Declaration

property MediaModes: DWord;

Remarks

Some devices not allow to use all supported media mode at the same time, so that you have to restrict them to the one you need. To be aware of the active media modes while the device is active, see the property ThbTapiLine.Status.OpenMediaModes.