LINEDEVSTATUS-Struktur (tapi.h)

Artikel
08/26/2023

Die LINEDEVSTATUS-Struktur beschreibt den aktuellen status eines Leitungsgeräts. Die LineGetLineDevStatus-Funktion und die TSPI_lineGetLineDevStatus-Funktion geben die LINEDEVSTATUS-Struktur zurück.

Syntax

typedef struct linedevstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumOpens;
  DWORD dwOpenMediaModes;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwLineFeatures;
  DWORD dwNumCallCompletions;
  DWORD dwRingMode;
  DWORD dwSignalLevel;
  DWORD dwBatteryLevel;
  DWORD dwRoamMode;
  DWORD dwDevStatusFlags;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwAvailableMediaModes;
  DWORD dwAppInfoSize;
  DWORD dwAppInfoOffset;
} LINEDEVSTATUS, *LPLINEDEVSTATUS;

Member

dwTotalSize

Gesamtgröße, die dieser Datenstruktur in Bytes zugeordnet ist.

dwNeededSize

Größe für diese Datenstruktur, die benötigt wird, um alle zurückgegebenen Informationen in Bytes zu enthalten.

dwUsedSize

Größe des Teils dieser Datenstruktur, der nützliche Informationen enthält, in Bytes.

dwNumOpens

Die Anzahl der aktiven Wird auf dem Linegerät geöffnet.

dwOpenMediaModes

Bitarray, das angibt, für welche Medientypen das Leitungsgerät derzeit geöffnet ist.

dwNumActiveCalls

Die Anzahl der Anrufe in der Zeile in anderen Anrufzuständen als Leerlauf, Zurückhaltung, Rückhaltungsübertragung und Rückhalten ausstehender Rückschluss.

dwNumOnHoldCalls

Anzahl der Anrufe in der Zeile im Zurückhaltungszustand .

dwNumOnHoldPendCalls

Anzahl der Anrufe in der Zeile im Zustand " onholdpendingtransfer" oder "onholdpendingconference ".

dwLineFeatures

Zeilenbezogene Funktionen, die derzeit in dieser Zeile verfügbar sind. Dieses Element verwendet mindestens eine der LINEFEATURE_ Konstanten.

dwNumCallCompletions

Anzahl der ausstehenden Anruferledigungsanforderungen in der Zeile.

dwRingMode

Aktueller Ringmodus auf dem Liniengerät.

dwSignalLevel

Aktueller Signalpegel der Verbindung auf der Leitung. Dies ist ein Wert im Bereich 0x00000000 (schwächstes Signal) bis 0x0000FFFF (stärkstes Signal).

dwBatteryLevel

Aktueller Akkustand der Gerätehardware des Line-Geräts. Dies ist ein Wert im Bereich 0x00000000 (Akku leer) bis 0x0000FFFF (akkulastig).

dwRoamMode

Aktueller Roam-Modus des Leitungsgeräts. Dieses Element verwendet eine der LINEROAMMODE_ Konstanten.

dwDevStatusFlags

Flags, die status Informationen angeben, z. B. ob das Gerät gesperrt ist. Sie besteht aus einem oder mehreren Elementen von LINEDEVSTATUSFLAGS_ Konstanten.

dwTerminalModesSize

Größe des gerätevariablen Felds, das ein Array aktueller Terminalmodi in Bytes enthält.

dwTerminalModesOffset

Offset vom Anfang der Struktur zu einem Array aktueller Terminalmodi in Bytes. Dieses Array wird nach Terminal-IDs im Bereich von null bis dwNumTerminals minus 1 indiziert. Jeder Eintrag im Array gibt die aktuellen Terminalmodi für den entsprechenden Terminalsatz an, indem die lineSetTerminal-Funktion für diese Zeile verwendet wird. Jeder Eintrag ist ein DWORD , der mindestens eine der LINETERMMODE_ Konstanten angibt. Die Größe des Arrays wird von dwTerminalModesSize angegeben.

dwDevSpecificSize

Größe des variabel großen gerätespezifischen Felds in Bytes. Wenn es sich bei den gerätespezifischen Informationen um einen Zeiger auf eine Zeichenfolge handelt, muss die Größe den NULL-Abschlussator enthalten.

dwDevSpecificOffset

Offset vom Anfang der Struktur zum gerätespezifischen Feld in Bytes. Die Größe des Felds wird von dwDevSpecificSize angegeben.

dwAvailableMediaModes

Gibt die Medientypen an, die für neue Aufrufe aufgerufen werden können, die auf diesem Zeilengerät erstellt wurden, wenn das dwLineFeatures-Element angibt, dass neue Aufrufe möglich sind. Wenn dieser Member null ist, gibt dies an, dass der Dienstanbieter entweder nicht weiß oder nicht angeben kann, welche Medientypen verfügbar sind. In diesem Fall sind möglicherweise alle oder alle medientypen verfügbar, die im dwMediaModes-Member in LINEDEVCAPS angegeben sind.

dwAppInfoSize

Größe des Arrays, das die Anwendungen identifiziert, für die die Zeile geöffnet ist, in Bytes.

dwAppInfoOffset

Offset vom Anfang der Struktur zu einem Array von LINEAPPINFO-Strukturen . Das dwNumOpens-Element gibt die Anzahl der Elemente im Array an. Jedes Element im Array identifiziert eine Anwendung, bei der die Zeile geöffnet ist. Die Größe des Arrays wird von dwAppInfoSize angegeben.

Hinweise

Gerätespezifische Erweiterungen sollten den DevSpecific -Bereich (dwDevSpecificSize und dwDevSpecificOffset) verwenden, der variabel groß ist.

Die Mitglieder dwAvailableMediaModes über dwAppInfoOffset sind nur für Anwendungen verfügbar, die das Leitungsgerät mit einer API-Version von 2.0 oder höher öffnen.