IWiaMiniDrv：:d rvDeviceCommand 方法 (wiamindr_lh.h)
IWiaMiniDrv：:d rvDeviceCommand 方法向 WIA 设备发出命令。
语法
HRESULT drvDeviceCommand(
BYTE *__MIDL__IWiaMiniDrv0043,
LONG __MIDL__IWiaMiniDrv0044,
const GUID *__MIDL__IWiaMiniDrv0045,
IWiaDrvItem **__MIDL__IWiaMiniDrv0046,
LONG *__MIDL__IWiaMiniDrv0047
);
参数
__MIDL__IWiaMiniDrv0043
lFlags [in]
保留。
__MIDL__IWiaMiniDrv0044
pWiasContext [in]
指向 WIA 项上下文的指针。
__MIDL__IWiaMiniDrv0045
plCommand [in]
指向 WIA 命令 GUID。
__MIDL__IWiaMiniDrv0046
plDevErrVal [out]
指向将接收此方法的状态代码的内存位置。 如果此方法返回 S_OK，则存储的值将为零。 否则，微型驱动程序特定的错误代码将存储在此参数指向的位置。
__MIDL__IWiaMiniDrv0047
ppWiaDrvItem [out， optional]
指向可以接收指向 IWiaDrvItem 接口的指针的内存位置。 请参阅下面的备注。
返回值
成功后，方法应返回 S_OK 并清除 plDevErrVal 指向的设备错误值。 如果方法失败，它应返回标准 COM 错误代码，并在 plDevErrVal 指向的内存中放置一个特定于微型驱动程序的错误代码值。
plDevErrVal 指向的值可以通过调用 IWiaMiniDrv：:d rvGetDeviceErrorStr 转换为字符串。
注解
WIA 服务调用方法 IWiaMiniDrv：:d rvDeviceCommand ，向设备发出 WIA 服务或应用程序生成的命令。 WIA 服务仅为 设备可以在方法 IWiaMiniDrv：:d rvGetCapabilities 中支持的命令调用 IWiaMiniDrv：:d rvDeviceCommand 方法。
ppWiaDrvItem 参数应被视为可选参数，因为微型驱动程序通常不会设置它指向的内存位置。 但是，对于某些命令，微型驱动程序会将新创建的项的地址放在此参数指向的位置中。 例如，如果发出用于拍照的命令 (plCommand 设置为 WIA_CMD_TAKE_PICTURE) ，则设备将生成新图像，导致微型驱动程序在驱动程序项树中创建新项，并将 *ppWiaDrvItem 设置为新项的地址。 这会通知 WIA 服务已创建新项。
微型驱动程序可能包含设备可以在 方法 IWiaMiniDrv：:d rvGetCapabilities 中支持的自定义命令列表。
WIA 服务在调用此方法之前不会写入任何属性。 如果命令依赖于属性设置，微型驱动程序应在发出命令之前调用 IWiaMiniDrv：:d rvWriteItemProperties 。 例如，用于拍照 的命令（WIA_CMD_TAKE_PICTURE）可能依赖于快门速度和光圈设置，这些设置需要在发出命令之前写入设备。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | wiamindr_lh.h (包括 Wiamindr.h) |