TSPI_lineGetDevCaps-Funktion (tspi.h)

Die TSPI_lineGetDevCaps-Funktion fragt ein angegebenes Leitungsgerät ab, um dessen Telefoniefunktionen zu ermitteln. Die zurückgegebenen Informationen sind für alle Adressen auf dem Leitungsgerät gültig.

Syntax

LONG TSPIAPI TSPI_lineGetDevCaps(
  DWORD         dwDeviceID,
  DWORD         dwTSPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

Parameter

dwDeviceID

Das abzufragte Zeilengerät.

dwTSPIVersion

Die ausgehandelte TSPI-Versionsnummer. Dieser Wert wurde für dieses Gerät bereits über die TSPI_lineNegotiateTSPIVersion-Funktion ausgehandelt.

dwExtVersion

Die ausgehandelte Erweiterungsversionsnummer. Dieser Wert wurde für dieses Gerät bereits über die TSPI_lineNegotiateExtVersion-Funktion ausgehandelt. Dieser Parameter wird nicht von TAPI überprüft, wenn diese Funktion aufgerufen wird.

lpLineDevCaps

Ein Zeiger auf eine strukturvariable Größe vom Typ LINEDEVCAPS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Informationen zu Den Funktionen des Zeilengeräts 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 wie folgt:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

Hinweise

Die Nummerierung des Zeilengerätebezeichners für einen Dienstanbieter ist sequenziell von dem Wert, der durch den dwLineDeviceIDBase-Parameter festgelegt wird, der an die TSPI_providerInit-Funktion übergeben wird.

Der formale Parameter dwExtVersion gibt die Versionsnummer der angeforderten Erweiterungsinformationen an. Wenn es null ist, werden keine Erweiterungsinformationen angefordert. Wenn es nicht zero ist, enthält es einen Wert, der für dieses Gerät mit der TSPI_lineNegotiateExtVersion-Funktion ausgehandelt wurde. Der Dienstanbieter füllt geräte- und herstellerspezifische erweiterte Informationen gemäß der angegebenen Erweiterungsversion aus.

Der Dienstanbieter füllt alle Member der LINEDEVCAPS-Datenstruktur aus, mit Ausnahme von dwTotalSize, das von TAPI ausgefüllt wird. Der Dienstanbieter darf den dwTotalSize-Member nicht überschreiben.

Der Dienstanbieter muss alle Elemente der LINETERMCAPS-Datenstruktur oder -strukturen ausfüllen, die in den unterschiedlichen Teil der LINEDEVCAPS-Datenstruktur eingebettet sind.

Nachdem der Dienstanbieter von der funktion TSPI_lineGetDevCaps zurückgegeben hat, legt TAPI den dwLinesStates-Member der LINEDEVCAPS-Struktur wie folgt fest:

LINEDEVCAPS.dwLineStates |=
    LINEDEVSTATE_OPEN |
    LINEDEVSTATE_CLOSE |
    LINEDEVSTATE_REINIT |
    LINEDEVSTATE_TRANSLATECHANGE;

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	tspi.h

Weitere Informationen

LINEDEVCAPS

LINETERMCAPS

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion

TSPI_providerInit