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

Weitere Informationen

LINEDEVSTATUS

TSPI_lineGetAddressStatus