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）可能依赖于快门速度和光圈设置，这些设置需要在发出命令之前写入设备。

要求

另请参阅

IWiaMiniDrv

IWiaMiniDrv：:d rvGetCapabilities

IWiaMiniDrv：:d rvWriteItemProperties