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 |
|