PHONE_STATE Nachricht

TAPI sendet die PHONE_STATE Nachricht an eine Anwendung, wenn sich die status eines Telefongeräts ändert.

Parameter

hPhone

Ein Handle für das Telefongerät.

dwCallbackInstance

Der Rückruf der Anwendung instance beim Öffnen des Telefongeräts bereitgestellt.

dwParam1

Der geänderte Telefonstatus. Dieser Parameter verwendet eine der PHONESTATE_ Konstanten.

dwParam2

Vom Telefonzustand abhängige Informationen zur status Änderung. Dieser Parameter wird nicht verwendet, wenn mehrere Flags in dwParam1 festgelegt werden, da mehrere status Elemente geändert wurden. Die Anwendung sollte phoneGetStatus aufrufen, um einen vollständigen Satz von Informationen abzurufen.

Wenn dwParam1 PHONESTATE_OWNER ist, enthält dwParam2 die neue Anzahl von Besitzern.

Wenn dwParam1 PHONESTATE_MONITORS ist, enthält dwParam2 die neue Anzahl von Monitoren.

Wenn dwParam1 PHONESTATE_LAMP ist, enthält dwParam2 den Schaltflächen-/Lampenbezeichner der geänderten Lampe.

Wenn dwParam1 PHONESTATE_RINGMODE ist, enthält dwParam2 den neuen Ringmodus.

Wenn dwParam1 PHONESTATE_HANDSET, LAUTSPRECHER oder HEADSET ist, enthält dwParam2 den neuen Hookswitch-Modus dieses Hookswitch-Geräts. Dieser Parameter verwendet eine der PHONEHOOKSWITCHMODE_ Konstanten.

dwParam3

Nicht verwendet.

Rückgabewert

Kein Rückgabewert.

Bemerkungen

Das Senden der PHONE_STATE Nachricht an die Anwendung kann mithilfe von phoneSetStatusMessages und phoneGetStatusMessages gesteuert und abgefragt werden. Standardmäßig ist diese Meldung für alle Zustandsänderungen deaktiviert, mit Ausnahme von PHONESTATE_REINIT, die nicht deaktiviert werden können. Diese Nachricht wird an alle Anwendungen gesendet, die über ein Handle für das Telefon verfügen, einschließlich der Anwendungen, die phoneOpen aufgerufen haben, wobei der dwPrivileges-Parameter auf PHONEPRIVILEGE_OWNER oder PHONEPRIVILEGE_MONITOR festgelegt ist.

Eine PHONE_STATE Nachricht mit einer Besitzer- und/oder Monitor-Angabe wird an Anwendungen gesendet, die bereits über einen Handle für das Telefon verfügen. Dies kann das Ergebnis sein, dass eine andere Anwendung den Besitz oder die Überwachung des Telefongeräts mit phoneOpen, phoneClose oder phoneShutdown ändert.

Anforderungen

Anforderung	Wert
TAPI-Version	Erfordert TAPI 2.0 oder höher
Header	Tapi.h

Siehe auch

PHONE_CLOSE

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneOpen

phoneSetStatusMessages

phoneShutdown