TSPI_lineSelectExtVersion 函数 (tspi.h)
TSPI_lineSelectExtVersion 函数为指示的行设备选择指示的扩展版本。 后续请求根据该扩展版本运行。
语法
LONG TSPIAPI TSPI_lineSelectExtVersion(
HDRVLINE hdLine,
DWORD dwExtVersion
);
参数
hdLine
要为其选择扩展版本的行的句柄。
dwExtVersion
要选择的扩展版本。 此版本号已使用 TSPI_lineNegotiateExtVersion 协商。 最重要的 WORD 是主版本号，最小有效 WORD 是次要版本号。 使用 0 的 dwExtVersion 调用此函数将取消当前选择。
返回值
如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：
LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_OPERATIONUNAVAIL。
注解
服务提供商选择指示的扩展版本。 尽管指示的版本号可能已成功协商，但在此期间可能选择了其他扩展版本，在这种情况下，此函数 (返回LINEERR_INCOMPATIBLEEXTVERSION) 失败。
选择扩展版本后对行的后续操作会根据该扩展版本执行。 后续尝试协商扩展版本报告严格选择的版本;如果请求的范围不包含所选版本) ，则 (0。 使用特殊扩展版本 0 调用此过程将取消当前选择。 设备再次能够支持其全部扩展版本号范围。
此函数在 TAPI 级别没有直接对应关系，其中选择扩展版本与 lineOpen 的其他功能捆绑在一起。 TSPI_lineSelectExtVersion函数通常在两种情况下调用： (1) 请求打开行的应用程序、成功更改媒体类型监视、应用程序请求使用特定扩展版本，以及当前未选择任何扩展版本。 (2) 使用特定扩展版本的最后一个应用程序关闭了该行，并且可以取消选择扩展版本。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tspi.h |