Share via


LINE_DEVSPECIFIC message

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


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

Parameters

  • htLine
    The TAPI opaque object handle to the line device.

  • htCall
    Unused.

  • dwMsg
    The value LINE_DEVSPECIFIC.

  • dwParam1
    Device specific.

  • dwParam2
    Device specific.

  • dwParam3
    Device specific.

Remarks

The LINE_DEVSPECIFIC 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 is translated to the appropriate hLine as the hDevice parameter at the TAPI level. The dwParam1, dwParam2, and dwParam3 parameters are passed through unmodified.

This differs from the corresponding message at the TAPI level in that it is used only to report device-specific events occurring on a line or address. At the TSPI level, the LINE_CALLDEVSPECIFIC message is used to report device-specific events happening on a call.

Requirements

TAPI version

Requires TAPI 2.0 or later

Header

Tapi.h

See also

LINE_DEVSPECIFICEX

LINEEVENT

TSPI_lineDevSpecific