LINE_ADDRESSSTATE message

The TSPI LINE_ADDRESSSTATE message is sent to the LINEEVENT callback function when the status of an address changes on a line that is currently open by TAPI. TAPI can invoke TSPI_lineGetAddressStatus to determine the current status of the address.


LINE_ADDRESSSTATE
htLine = (HTAPILINE) hLineDevice;
htCall = (HTAPICALL) 0;
dwMsg = (DWORD) LINE_ADDRESSSTATE;
dwParam1 = (DWORD) idAddress;
dwParam2 = (DWORD) AddressState;
dwParam3 = (DWORD) 0;
            

Parameters

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

  • htCall
    Unused.

  • dwMsg
    The value LINE_ADDRESSSTATE.

  • dwParam1
    The address identifier of the address that changed status.

  • dwParam2
    The address state that changed. This parameter can be a combination of the LINEADDRESSSTATE_ constants.

  • dwParam3
    Unused.

Remarks

The LINE_ADDRESSSTATE message is sent whenever the line is open by TAPI and an event occurs in which TAPI has expressed an interest. TAPI uses the TSPI_lineSetStatusMessages function to specify the set of status-change events in which it is interested. By default, address status reporting is disabled.

For backward compatibility, older service providers are not expected to generate this value in a LINE_ADDRESSSTATE message. If they do, the message should be handled in the same manner as for newer service providers (as described earlier).

Requirements

TAPI version

Requires TAPI 2.0 or later

Header

Tapi.h

See also

LINE_LINEDEVSTATE

LINEADDRESSCAPS

LINEADDRESSSTATUS

LINEEVENT

TSPI_lineGetAddressStatus

TSPI_lineSetStatusMessages