LINE_CALLDEVSPECIFIC

The TSPI LINE_CALLDEVSPECIFIC message is sent to the LINEEVENT callback function to notify TAPI about device-specific events occurring on a call. The meaning of the message and the interpretation of the dwParam1 through dwParam3 parameters is device specific.

LINE_CALLDEVSPECIFIC
htLine = (HTAPILINE) hLineDevice;
htCall = (HTAPICALL) hCallDevice;
dwMsg = (DWORD) LINE_CALLDEVSPECIFIC;
dwParam1 = (DWORD) DeviceData1;
dwParam2 = (DWORD) DeviceData2;
dwParam3 = (DWORD) DeviceData3;

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_CALLDEVSPECIFIC.

dwParam1

Device specific.

dwParam2

Device specific.

dwParam3

Device specific.

Remarks

The LINE_CALLDEVSPECIFIC message is used by a service provider in conjunction with the TSPI_lineDevSpecific function. Its meaning is device specific.

TAPI sends the LINE_DEVSPECIFIC message to applications in response to receiving this message from a service provider. The htLine and htCall parameters are translated to the appropriate hCall as the hDevice parameter at the TAPI level. The dwParam1, dwParam2, and dwParam3 parameters are passed through unmodified.

There is no directly corresponding message at the TAPI level, although this message is very similar to LINE_DEVSPECIFIC. At the TSPI level, the device-specific messages are split between those reporting events on lines and addresses, and those reporting events on calls.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later.
  Version: Requires TAPI 2.0 or later.
  Header: Declared in Tspi.h.

See Also

LINE_DEVSPECIFIC, LINEEVENT, TSPI_lineDevSpecific