LINE_MONITORMEDIA

The LINE_MONITORMEDIA message is sent to the LINEEVENT callback function whenever a change in the call's media mode is detected and media mode monitoring is enabled. The sending of this message is controlled by the TSPI_lineMonitorMedia function.

LINE_MONITORMEDIA
htLine = (HTAPILINE) hLineDevice;
htCall = (HTAPICALL) hCallDevice;
dwMsg = (DWORD) LINE_MONITORDIGITS;
dwParam1 = (DWORD) LineMediaMode;
dwParam2 = (DWORD) 0;
dwParam3 = (DWORD) dwTickCount;
 

Parameters

htLine

The TAPI opaque object handle to the line device.

htCall

The TAPI opaque object handle to the call device.

dwMsg

The value LINE_MONITORMEDIA.

dwParam1

Specifies the new media mode. This parameter can be one of the following LINEMEDIAMODE_ constants:

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 session on the call. TDD stands for Telephony Devices for the Deaf.

LINEMEDIAMODE_G4FAX

A group 4 fax is being sent or received over the call.

LINEMEDIAMODE_DIGITALDATA

Digital data 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 telematic services.

LINEMEDIAMODE_ADSI

An ADSI (Analog Display Services Interface) session on the call.

LINEMEDIAMODE_VOICEVIEW

The media mode of the call is VoiceView.

dwParam2

Unused.

dwParam3

Service providers insert into dwParam3 the "tick count" (number of milliseconds since Windows started), obtained from GetTickCount, at which the specified media was detected.

Remarks

This message is sent only when media mode monitoring is enabled.

See Also

LINEEVENT, LINEMEDIAMODE_ Constants, TSPI_lineMonitorMedia