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 |