TSPI_lineNegotiateTSPIVersion-Funktion (tspi.h)

2023-08-26

Die TSPI_lineNegotiateTSPIVersion-Funktion gibt die höchste SPI-Version zurück, unter der der Dienstanbieter für dieses Gerät arbeiten kann, da der Bereich der möglichen SPI-Versionen vorhanden ist.

Syntax

LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(
  DWORD   dwDeviceID,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwTSPIVersion
);

Parameter

dwDeviceID

Gibt das Leitungsgerät an, für das die Schnittstellenversionsverhandlung ausgeführt werden soll. Zusätzlich zu den Gerätebezeichnern innerhalb des bereichs, den der Dienstanbieter unterstützt, kann dies der Wert sein:

INITIALIZE_NEGOTIATION

Dieser Wert wird verwendet, um anzugeben, dass eine Allgemeine Schnittstellenversion ausgehandelt werden soll.

dwLowVersion

Die niedrigste TSPI-Versionsnummer, unter der TAPI betrieben werden kann. Die wichtigste WORD-Version ist die Hauptversionsnummer, und das am wenigsten signifikante WORD ist die Nebenversionsnummer.

dwHighVersion

Die höchste TSPI-Versionsnummer, unter der TAPI betrieben werden kann. Die wichtigste WORD-Version ist die Hauptversionsnummer, und das am wenigsten signifikante WORD ist die Nebenversionsnummer.

lpdwTSPIVersion

Ein Zeiger auf ein DWORD. Der Dienstanbieter füllt diesen Speicherort mit der höchsten TSPI-Versionsnummer innerhalb des vom Aufrufer angeforderten Bereichs, unter dem der Dienstanbieter arbeiten kann. Die wichtigste WORD-Version ist die Hauptversionsnummer, und das am wenigsten signifikante WORD ist die Nebenversionsnummer. Wenn sich der angeforderte Bereich nicht mit dem vom Dienstanbieter unterstützten Bereich überschneidet, gibt die Funktion LINEERR_INCOMPATIBLEAPIVERSION zurück.

Rückgabewert

Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

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

Hinweise

Wenn dwDeviceIDINITIALIZE_NEGOTIATION ist, darf diese Funktion keine LINEERR_OPERATIONUNAVAIL zurückgeben, da diese Funktion (mit diesem Wert) für die Verhandlung der gesamten Schnittstellenversion obligatorisch ist, auch wenn der Dienstanbieter keine Leitungsgeräte unterstützt.