TSPI_lineGetDevCaps 函数 (tspi.h)

  • 项目

TSPI_lineGetDevCaps函数查询指定的线路设备以确定其电话功能。 返回的信息对线路设备上的所有地址都有效。

语法

LONG TSPIAPI TSPI_lineGetDevCaps(
  DWORD         dwDeviceID,
  DWORD         dwTSPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

参数

dwDeviceID

要查询的线路设备。

dwTSPIVersion

协商的 TSPI 版本号。 此值已通过 TSPI_lineNegotiateTSPIVersion 函数为此设备协商。

dwExtVersion

协商的扩展版本号。 此值已通过 TSPI_lineNegotiateExtVersion 函数为此设备协商。 调用此函数时，TAPI 不会验证此参数。

lpLineDevCaps

指向 LINEDEVCAPS 类型的可变大小的结构的指针。 成功完成请求后，此结构将填充线路设备功能信息。

返回值

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

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONUNAVAIL、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONFAILED、LINEERR_NODRIVER、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM。

注解

服务提供商的线路设备标识符编号与传递给 TSPI_providerInit 函数的 dwLineDeviceIDBase 参数设置的值是连续 的 。

dwExtVersion 形式参数指示所请求扩展信息的版本号。 如果为零，则不请求任何扩展信息。 如果为非零值，则保留一个值，该值是使用 TSPI_lineNegotiateExtVersion 函数为此设备协商的值。 服务提供商根据指定的扩展版本填写特定于设备和供应商的扩展信息。

服务提供商将填充 LINEDEVCAPS 数据结构的所有成员， dwTotalSize 除外，该成员由 TAPI 填充。 服务提供程序不得覆盖 dwTotalSize 成员。

服务提供商必须填充 LINETERMCAPS 数据结构的所有成员或嵌入在 LINEDEVCAPS 数据结构的不同部分的结构。

在服务提供商从 TSPI_lineGetDevCaps 函数返回后，TAPI 按如下所示设置 LINEDEVCAPS 结构的 dwLinesStates 成员：

LINEDEVCAPS.dwLineStates |=
    LINEDEVSTATE_OPEN |
    LINEDEVSTATE_CLOSE |
    LINEDEVSTATE_REINIT |
    LINEDEVSTATE_TRANSLATECHANGE;

要求

要求 值
目标平台 Windows
标头 tspi.h

另请参阅

LINEDEVCAPS

LINETERMCAPS

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion

TSPI_providerInit