phoneGetDevCapsA 函数（tapi.h）

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

语法

LONG phoneGetDevCapsA(
  HPHONEAPP   hPhoneApp,
  DWORD       dwDeviceID,
  DWORD       dwAPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

参数

hPhoneApp

使用 TAPI 处理应用程序的注册。

dwDeviceID

要查询的电话设备的标识符。

dwAPIVersion

要使用的电话 API 的版本号。高序单词包含主版本号;低序字包含次要版本号。此数字是通过函数 phoneNegotiateAPIVersion获取的。

dwExtVersion

要使用的特定于服务提供商的扩展的版本号。此数字是通过 phoneNegotiateExtVersion函数获取的。如果未使用任何特定于设备的扩展，则可以将其保留为零。否则，高序单词包含主要版本号;低序字包含次要版本号。

lpPhoneCaps

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

返回值

如果请求成功，则返回零;如果发生错误，则返回负错误号。可能的返回值为：

PHONEERR_INVALAPPHANDLE、PHONEERR_INVALPOINTER、PHONEERR_BADDEVICEID、PHONEERR_OPERATIONFAILED、PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_NOMEM、PHONEERR_STRUCTURETOOSMALL、PHONEERR_RESOURCEUNAVAIL、PHONEERR_NODRIVER、PHONEERR_UNINITIALIZED、PHONEERR_NODEVICE。