phoneGetDevCaps 函数 (tapi.h)

项目
08/26/2023

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

语法

LONG phoneGetDevCaps(
  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。