TSPI_lineGetLineDevStatus-Funktion (tspi.h)
Die TSPI_lineGetLineDevStatus-Funktion fragt das angegebene Open Line-Gerät nach seiner aktuellen status ab. Die zurückgegebenen Informationen sind global für alle Adressen in der Zeile.
Syntax
LONG TSPIAPI TSPI_lineGetLineDevStatus(
HDRVLINE hdLine,
LPLINEDEVSTATUS lpLineDevStatus
);
Parameter
hdLine
Das Handle des Dienstanbieters für die abzufragte Zeile.
lpLineDevStatus
Ein Zeiger auf eine Datenstruktur mit unterschiedlicher Größe vom Typ LINEDEVSTATUS. Diese Struktur wird mit dem gerätespezifischen status der Leitung gefüllt.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Hinweise
Die folgende Tabelle gibt an, welche Member der LINEDEVSTATUS-Datenstruktur von TAPI ausgefüllt und welche vom Dienstanbieter ausgefüllt werden. Der Dienstanbieter muss die von TAPI ausgefüllten Werte beibehalten (darf nicht überschrieben werden).
| Membername | TAPI | Dienstanbieter |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwNumOpens; | X | |
| dwOpenMediaModes; | X | |
| dwNumActiveCalls; | X | |
| dwNumOnHoldCalls; | X | |
| dwNumOnHoldPendCalls; | X | |
| dwLineFeatures; | X | |
| dwNumCallCompletions; | X | |
| dwRingMode; | X | |
| dwSignalLevel; | X | |
| dwBatteryLevel; | X | |
| dwRoamMode; | X | |
| dwDevStatusFlags; | X | |
| dwTerminalModesSize; | X | |
| dwTerminalModesOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |