TSPI_lineNegotiateTSPIVersion函式 (tspi.h)

發行項
03/03/2024

TSPI_lineNegotiateTSPIVersion函式會傳回服務提供者可針對此裝置運作的最高 SPI 版本，因為有可能的 SPI 版本範圍。

語法

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

參數

dwDeviceID

識別要執行介面版本交涉的行裝置。除了服務提供者所支援範圍內的裝置標識碼之外，這可能是值：

INITIALIZE_NEGOTIATION

這個值用來表示要交涉整體介面版本。

dwLowVersion

TAPI 可以運作的最低 TSPI 版本號碼。最重要的 WORD 是主要版本號碼，而最小有效 WORD 是次要版本號碼。

dwHighVersion

TAPI 可以運作的最高 TSPI 版本號碼。最重要的 WORD 是主要版本號碼，而最小有效 WORD 是次要版本號碼。

lpdwTSPIVersion

DWORD 的指標。服務提供者會在呼叫者要求的範圍內，以最高的 TSPI 版本號碼填入此位置，而服務提供者可以在該範圍內運作。最重要的 WORD 是主要版本號碼，而最小有效 WORD 是次要版本號碼。如果要求的範圍與服務提供者支援的範圍不重疊，函式會傳回LINEERR_INCOMPATIBLEAPIVERSION。