Platform SDK: TAPI |
The TSPI PHONE_STATE message is sent to the PHONEEVENT callback function to TAPI whenever a phone device's status changes.
PHONE_STATE htPhone = (HTAPIPHONE) hPhoneDevice; dwMsg = (DWORD) PHONE_STATE; dwParam1 = (DWORD) PhoneState; dwParam2 = (DWORD) PhoneStateData; dwParam3 = (DWORD) 0;
The sending of this message is controlled by TSPI_phoneSetStatusMessages. By default, this message is disabled for all state changes.
The service provider never reports changed values for PHONESTATE_OWNER or PHONESTATE_MONITORS, because the notion of privilege does not appear at the TSPI level.
For backward compatibility, older service providers are not expected to generate this value in a PHONE_STATE message. If they do, the message is 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.
PHONEEVENT, PHONEHOOKSWITCHMODE_ Constants, PHONESTATE_ Constants, TSPI_phoneGetStatus, TSPI_phoneSetStatusMessages