LINEDEVSTATUS-Struktur (tapi.h)
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.
Anforderungen
Kopfzeile | tapi.h |