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 结构的数组的第一个元素的地址，这些结构包含设备支持的事件和命令的 GUID。
返回值
成功后，该方法应返回 S_OK 并清除 plDevErrVal 指向的设备错误值。 如果方法失败，它应返回标准 COM 错误代码，并将特定于微型驱动程序的错误代码值放在 plDevErrVal 指向的内存中。
plDevErrVal 指向的值可以通过调用 IWiaMiniDrv：:d rvGetDeviceErrorStr 转换为字符串。
注解
WIA 服务调用 minidriver 方法 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) |