IWiaMiniDrv::d rvGetCapabilities 方法 (wiamindr_lh.h)

IWiaMiniDrv::d rvGetCapabilities 方法返回设备支持的事件和命令数组。

语法

HRESULT drvGetCapabilities(
  BYTE            *__MIDL__IWiaMiniDrv0048,
  LONG            __MIDL__IWiaMiniDrv0049,
  LONG            *__MIDL__IWiaMiniDrv0050,
  WIA_DEV_CAP_DRV **__MIDL__IWiaMiniDrv0051,
  LONG            *__MIDL__IWiaMiniDrv0052
);

参数

__MIDL__IWiaMiniDrv0048

lFlags [in]

指定由 ppCapabilites 指向的数组是由命令或事件组成的,还是由两者组成。 此参数可以是以下标志之一,也可以是 OR 运算符组合的两个标志。

描述
WIA_DEVICE_COMMANDS 该数组由设备命令组成。
WIA_DEVICE_EVENTS 该数组由设备事件组成。

__MIDL__IWiaMiniDrv0049

pWiasContext [in]

指向 WIA 项上下文的指针。

__MIDL__IWiaMiniDrv0050

pcelt [out]

指向一个内存位置,该位置将接收 ppCapabilities 参数指向的数组中的元素数。

__MIDL__IWiaMiniDrv0051

plDevErrVal [out]

指向将接收此方法的状态代码的内存位置。 如果此方法返回 S_OK,则存储的值将为零。 否则,微型驱动程序特定的错误代码将存储在此参数指向的位置。

__MIDL__IWiaMiniDrv0052

ppCapabilities [out, optional]

指向一个内存位置,该位置将接收包含设备支持的事件和命令的 WIA_DEV_CAP_DRV 结构数组的第一个元素的地址。

返回值

成功后,该方法应返回 S_OK 并清除 plDevErrVal指向的设备错误值。 如果方法失败,它应返回标准 COM 错误代码,并将特定于微型驱动程序的错误代码值放在 plDevErrVal指向的内存中。

plDevErrVal 指向的值可以通过调用 IWiaMiniDrv::d rvGetDeviceErrorStr转换为字符串。

言论

WIA 服务 IWiaMiniDrv::d rvGetCapabilities 调用微型驱动程序方法,以获取硬件命令功能和/或设备事件的列表。 为了响应此调用,微型驱动程序使用指向 GUID 数据的指针数组的地址设置 ppCapabilities。 每个 GUID 对应于映像设备支持的事件通知或设备命令。 当 lFlags 参数设置为WIA_DEVICE_COMMANDS时,GUID 数组包含设备命令。 lFlags 设置为WIA_DEVICE_EVENTS时,GUID 数组包含事件。 如果将 lFlags 设置为 WIA_DEVICE_COMMANDS |WIA_DEVICE_EVENTS,GUID 数组包含按该顺序列出的事件和命令。

Wiadef.h 标头列出了多个预定义的命令和事件。

要求

要求 价值
目标平台 桌面
标头 wiamindr_lh.h (包括 Wiamindr.h)

另请参阅

IWiaMiniDrv

IWiaMiniDrv::d rvGetDeviceErrorStr

WIA_DEV_CAP_DRV