LINE _ LINEDEVSTATE-Meldung
Die TAPI LINE _ LINEDEVSTATE-Nachricht wird gesendet, wenn sich der Zustand eines Liniengeräts geändert hat. Die Anwendung kann lineGetLineDevStatus aufrufen, um den neuen Status der Zeile zu bestimmen.
Parameter
-
hDevice
-
Ein Handle für das Liniengerät. Dieser Parameter ist NULL, wenn dwParam1 auf LINEDEVSTATE _ REINIT festgelegt ist.
-
dwCallbackInstance
-
Die Rückrufinstanz, die beim Öffnen der Zeile angegeben wurde. Wenn der dwParam1-Parameter LINEDEVSTATE _ REINIT ist, ist der dwCallbackInstance-Parameter ungültig und auf 0 (null) festgelegt.
-
dwParam1
-
Das geänderte Element für den Gerätestatus der Zeile. Der -Parameter kann eine oder mehrere der LINEDEVSTATE-Konstanten _ sein.
-
dwParam2
-
Die Interpretation dieses Parameters hängt vom Wert von dwParam1 ab. Wenn dwParam1 LINEDEVSTATE RINGING ist, enthält dwParam2 den Ringmodus, mit dem der Schalter die Linie anweisen _ soll, zu ringen. Gültige Ringmodi sind Zahlen im Bereich 1 bis dwNumRingModes, wobei dwNumRingModes eine Gerätefunktion für Linien ist.
Wenn dwParam1 LINEDEVSTATE REINIT ist und die Nachricht von TAPI als Ergebnis der Übersetzung einer neuen API-Nachricht in eine REINIT-Nachricht ausgegeben wurde, enthält _ dwParam2 den dwMsg-Parameter der ursprünglichen Nachricht (z. B. LINE _ CREATE oder LINE _ LINEDEVSTATE). Wenn dwParam2 0 (null) ist, bedeutet dies, dass die REINIT-Nachricht eine "echte" REINIT-Nachricht ist, die erfordert, dass die Anwendung lineShutdown so früh wie möglich aufruft.
-
dwParam3
-
Die Interpretation dieses Parameters hängt vom Wert von dwParam1 ab. Wenn dwParam1 LINEDEVSTATE _ RINGING ist, enthält dwParam3 die Ringanzahl für dieses Ringereignis. Die Ringanzahl beginnt bei 0 (null).
Wenn dwParam1 LINEDEVSTATE REINIT ist und die Nachricht von TAPI als Ergebnis der Übersetzung einer neuen API-Nachricht in eine REINIT-Nachricht ausgegeben wurde, enthält dwParam3 den dwParam1-Parameter der ursprünglichen Nachricht (z. B. LINEDEVSTATE TRANSLATECHANGE oder einen anderen _ _ LINEDEVSTATE-Wert, wenn _ dwParam2 LINE _ LINEDEVSTATE ist, _oder den neuen Gerätebezeichner, wenn dwParam2 line create ist).
Rückgabewert
Kein Rückgabewert.
Hinweise
Das Senden der LINE _ LINEDEVSTATE-Nachricht kann mit lineSetStatusMessages gesteuert werden. Eine Anwendung kann Statuselementänderungen angeben, über die sie benachrichtigt werden möchte. Standardmäßig sind alle Statusberichte deaktiviert, mit Ausnahme von LINEDEVSTATE _ REINIT, die nicht deaktiviert werden können. Diese Meldung wird an alle Anwendungen gesendet, die über ein Handle für die Zeile verfügen, einschließlich der Anwendungen, die lineOpen aufgerufen haben, bei denen der dwPrivileges-Parameter auf LINECALLPRIVILEGE _ NONE, LINECALLPRIVILEGE _ OWNER, LINECALLPRIVILEGE MONITOR oder zulässige Kombinationen davon festgelegt _ ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 2.0 oder höher |
| Header |
|