Platform SDK: TAPI |
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;
This 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).
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 Tapi.h.
LINE_LINEDEVSTATE, LINEADDRESSCAPS, LINEADDRESSSTATUS, LINEEVENT, TSPI_lineGetAddressStatus, TSPI_lineSetStatusMessages