Share via

LINE_MONITORMEDIA message

  • Article

The TSPI LINE_MONITORMEDIA message is sent to the LINEEVENT callback function whenever a change in the call's media type is detected and media type 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_MONITORMEDIA;
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 type (mode). This parameter can be one of the LINEMEDIAMODE_ constants.

  • 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 type monitoring is enabled.

Requirements

TAPI version

 Requires TAPI 2.0 or later

Header

 Tapi.h

See also

LINEEVENT

LINEMEDIAMODE_ Constants

TSPI_lineMonitorMedia