通过

TSPI_lineGetAddressCaps 函数 (tspi.h)

  • 项目

TSPI_lineGetAddressCaps 函数查询指定线路设备上的指定地址，以确定其电话功能。

语法

LONG TSPIAPI TSPI_lineGetAddressCaps(
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwTSPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

参数

dwDeviceID

包含要查询的地址的线路设备。

dwAddressID

要查询其功能的给定线路设备上的地址。 地址标识符与地址永久关联;标识符在操作系统升级中保持不变。 调用此函数时，TAPI 不会验证此参数。

dwTSPIVersion

要使用的电话 SPI 的版本号。 高序字包含主版本号;低序字包含次要版本号。

dwExtVersion

要使用的特定于服务提供商的扩展的版本号。 如果不使用特定于设备的扩展，则此数字为零。 否则，高序字包含主版本号;低序字包含次要版本号。 调用此函数时，TAPI 不会验证此参数。

lpAddressCaps

指向 类型 LINEADDRESSCAPS 的可变大小结构的指针。 成功完成请求后，此结构将填充地址功能信息。

返回值

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

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

注解

特定驱动程序支持的行设备标识符从传递到 TSPI_providerInit 函数的 dwLineDeviceIDBase 值开始按顺序编号。

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

服务提供程序从 TSPI_lineGetAddressCaps 函数返回后，TAPI 按如下所示设置 LINEADDRESSCAPS 结构的 dwCallInfoStates 和 dwCallStates 成员：

LINEADDRESSCAPS.dwCallInfoStates |=
    LINECALLINFOSTATE_NUMOWNERINCR |
    LINECALLINFOSTATE_NUMOWNERDECR |
    LINECALLINFOSTATE_NUMMONITORS;

LINEADDRESSCAPS.dwCallStates |= LINECALLSTATE_UNKNOWN;

要求

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

另请参阅

LINEADDRESSCAPS

TSPI_providerInit