LINE_LINEDEVSTATE Nachricht
Die TAPI-LINE_LINEDEVSTATE Nachricht wird gesendet, wenn sich der Zustand eines Leitungsgeräts geändert hat. Die Anwendung kann lineGetLineDevStatus aufrufen, um die neue status der Zeile zu bestimmen.
Parameter
-
hGeräte
-
Ein Handle für das Leitungsgerät. Dieser Parameter ist NULL , wenn dwParam1 LINEDEVSTATE_REINIT ist.
-
dwCallbackInstance
-
Der Rückruf instance beim Öffnen der Zeile angegeben. Wenn der dwParam1-Parameter LINEDEVSTATE_REINIT ist, ist der dwCallbackInstance-Parameter ungültig und auf 0 festgelegt.
-
dwParam1
-
Das Zeilengerät status Element, das sich geändert hat. Der Parameter kann mindestens eine 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 Switch die Linie anweist, zu ringen. Gültige Ringmodi sind Zahlen im Bereich 1 bis dwNumRingModes, wobei dwNumRingModes eine Zeilengerätefunktion 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 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.
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 dwParam2LINE_CREATE ist).
Rückgabewert
Kein Rückgabewert.
Bemerkungen
Das Senden der LINE_LINEDEVSTATE Nachricht kann mit lineSetStatusMessages gesteuert werden. Eine Anwendung kann status Elementänderungen angeben, über die sie benachrichtigt werden möchte. Standardmäßig ist alle status Berichterstellung deaktiviert, mit Ausnahme von LINEDEVSTATE_REINIT, die nicht deaktiviert werden können. Diese Nachricht wird an alle Anwendungen gesendet, die über ein Handle für die Zeile verfügen, einschließlich der Anwendungen, die lineOpen aufgerufen haben, wobei der dwPrivileges-Parameter auf LINECALLPRIVILEGE_NONE, LINECALLPRIVILEGE_OWNER, LINECALLPRIVILEGE_MONITOR oder zulässige Kombinationen dieser festgelegt ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 2.0 oder höher |
| Header |
|