TSPI_phoneGetDevCaps 函数 (tspi.h)

TSPI_phoneGetDevCaps函数查询指定的电话设备以确定其电话功能。

语法

LONG TSPIAPI TSPI_phoneGetDevCaps(
  DWORD       dwDeviceID,
  DWORD       dwTSPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

参数

dwDeviceID

要查询的电话设备。

dwTSPIVersion

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

dwExtVersion

协商的扩展版本号。 此值通过 TSPI_phoneNegotiateExtVersion 函数为此设备协商。

lpPhoneCaps

指向内存的指针，服务提供程序在其中写入 PHONECAPS 类型的可变大小结构。 成功完成请求后，此结构将填充电话设备功能信息。 在调用 TSPI_phoneGetDevCaps之前，应用程序会设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。

返回值

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

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

注解

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

如果 dwExtVersion 为零，则不请求任何扩展信息。 如果它是非零值，则它包含已使用 TSPI_phoneNegotiateExtVersion 函数为此设备协商的值。 服务提供商根据指定的扩展版本填充特定于设备和供应商的扩展信息。

服务提供商从 TSPI_phoneGetDevCaps 函数返回后，TAPI 按如下所示设置 PHONECAPS 结构的 dwPhoneStates 成员：

PHONECAPS.dwPhoneStates |=
    PHONESTATE_OWNER |
    PHONESTATE_MONITORS |
    PHONESTATE_REINIT;

要求

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

另请参阅

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneNegotiateExtVersion