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 rvDeviceCommand 方法，以便设备可以在 IWiaMiniDrv：:d rvGetCapabilities 的方法中支持该方法。
ppWiaDrvItem 参数应被视为可选，因为微型驱动程序通常不设置它指向的内存位置。 但是，对于某些命令，微型驱动程序会将新创建的项的地址放在此参数指向的位置。 例如，如果发出用于拍摄照片的命令（plCommand 设置为 WIA_CMD_TAKE_PICTURE），设备将生成一个新图像，导致微型驱动程序在驱动程序项树中创建新项，并将 *ppWiaDrvItem 设置为新项目的地址。 这会通知 WIA 服务已创建新项。
微型驱动程序可能包含设备可在 IWiaMiniDrv：:d rvGetCapabilities方法中支持的自定义命令列表。
WIA 服务在调用此方法之前不会写入任何属性。 如果命令依赖于属性设置，微型驱动程序应在发出命令之前调用 IWiaMiniDrv：:d rvWriteItemProperties。 例如，要拍摄照片的命令（WIA_CMD_TAKE_PICTURE）可能依赖于快门速度和光圈设置，这需要在发出命令之前写入设备。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | wiamindr_lh.h （包括 Wiamindr.h） |