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

Siehe auch

LINE_CLOSE

LINE_CREATE

LINEDEVCAPS

lineGetDevCaps

lineGetDevConfig

lineGetTranslateCaps

lineInitialize

lineÖffnen

lineSetStatusMessages

lineShutdown

LINETRANSLATECAPS

lineUncompleteCall