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
Tapi.h

Weitere Informationen

TELEFON _ SCHLIEßEN

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneOpen

phoneSetStatusMessages

phoneShutdown