TSPI_lineNegotiateTSPIVersion函数 (tspi.h)

项目
03/13/2024

鉴于可能的 SPI 版本范围， TSPI_lineNegotiateTSPIVersion 函数返回服务提供商可为此设备操作的最高 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。