PHONE _ STATE-Nachricht
TAPI sendet die PHONE _ STATE-Nachricht an eine Anwendung, wenn sich der Status eines Telefongeräts ändert.
Parameter
-
hPhone
-
Ein Handle für das Telefongerät.
-
dwCallbackInstance
-
Die Rückrufinstanz der Anwendung, die beim Öffnen des Telefongeräts bereitgestellt wird.
-
dwParam1
-
Der Telefonzustand, der sich geändert hat. Dieser Parameter verwendet eine der _ PHONESTATE-Konstanten.
-
dwParam2
-
Telefon zustandsabhängige Informationen zur Statusänderung. Dieser Parameter wird nicht verwendet, wenn in dwParam1 mehrere Flags festgelegt sind, da sich mehrere Statuselemente geändert haben. Die Anwendung sollte phoneGetStatus aufrufen, um einen vollständigen Satz von Informationen zu erhalten.
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 Bezeichner für die Schaltfläche/Lampe der geänderten Lampe.
Wenn dwParam1 phonestate _ RINGMODE ist, enthält dwParam2 den neuen Ringmodus.
Wenn dwParam1 PHONESTATE HANDSET, SPEAKER 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, bei denen der dwPrivileges-Parameter auf PHONEPRIVILEGE OWNER oder _ PHONEPRIVILEGE MONITOR festgelegt _ ist.
Eine PHONE _ STATE-Nachricht mit der Angabe Besitzer und/oder Monitore wird an Anwendungen gesendet, die bereits über ein Handle für das Telefon verfügen. Dies kann das Ergebnis einer anderen Anwendung sein, die den Besitz oder die Überwachung des Telefongeräts mit phoneOpen, phoneClose oder phoneShutdown ändert.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 2.0 oder höher |
| Header |
|