TSPI_phoneNegotiateExtVersion 函数 (tspi.h)

  • 项目

给定可能的扩展版本范围， TSPI_phoneNegotiateExtVersion 函数返回服务提供商为此设备操作时可以使用的最高扩展版本号。

语法

LONG TSPIAPI TSPI_phoneNegotiateExtVersion(
  DWORD   dwDeviceID,
  DWORD   dwTSPIVersion,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwExtVersion
);

参数

dwDeviceID

标识要为其执行接口版本协商的电话设备。

dwTSPIVersion

指定使用 TSPI_phoneNegotiateTSPIVersion 为此设备协商的接口版本号。 此函数根据此版本级别的接口规范运行。

dwLowVersion

TAPI 或其客户端应用程序可以运行的最低扩展版本号。 最重要的 WORD 是主版本号，最低有效 WORD 是次要版本号。

dwHighVersion

TAPI 或其客户端应用程序可以运行的最高扩展版本号。 最重要的 WORD 是主版本号，最低有效 WORD 是次要版本号。

lpdwExtVersion

指向 DWORD 的指针。 从此函数成功返回后，服务提供商会在调用方请求的范围内用最高分机版本号填充此位置，服务提供商可以在该范围内进行操作。 最重要的 WORD 是主版本号，最低有效 WORD 是次要版本号。 如果请求的范围不与服务提供程序支持的范围重叠，则函数将返回PHONEERR_INCOMPATIBLEEXTVERSION。

返回值

如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：

PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_OPERATIONFAILED、PHONEERR_NODRIVER、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NOMEM。

注解

可以在 TAPI 打开设备之前或之后调用此函数。 如果设备当前处于打开状态，并且已选择扩展版本，则函数应返回该版本号（如果该版本号在请求的范围内）。 如果所选版本号超出请求的范围，则函数返回PHONEERR_INCOMPATIBLEEXTVERSION。

要求

   
目标平台 Windows
标头 tspi.h

另请参阅

TSPI_phoneNegotiateTSPIVersion