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 运算符组合的这两个标志。

__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 标头列出了多个预定义的命令和事件。

要求

另请参阅

IWiaMiniDrv

IWiaMiniDrv：:d rvGetDeviceErrorStr

WIA_DEV_CAP_DRV