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

要求

   
目标平台 桌面
Header wiamindr_lh.h (包括 Wiamindr.h)

另请参阅

IWiaMiniDrv

IWiaMiniDrv::d rvGetCapabilities

IWiaMiniDrv::d rvWriteItemProperties