IWiaMiniDrv：:d rvInitializeWia 方法 (wiamindr_lh.h)

项目
03/05/2024

IWiaMiniDrv：:d rvInitializeWia 方法初始化微型驱动程序并生成表示设备的驱动程序项树。

语法

HRESULT drvInitializeWia(
  BYTE        *__MIDL__IWiaMiniDrv0000,
  LONG        __MIDL__IWiaMiniDrv0001,
  BSTR        __MIDL__IWiaMiniDrv0002,
  BSTR        __MIDL__IWiaMiniDrv0003,
  IUnknown    *__MIDL__IWiaMiniDrv0004,
  IUnknown    *__MIDL__IWiaMiniDrv0005,
  IWiaDrvItem **__MIDL__IWiaMiniDrv0006,
  IUnknown    **__MIDL__IWiaMiniDrv0007,
  LONG        *__MIDL__IWiaMiniDrv0008
);

参数

__MIDL__IWiaMiniDrv0000

bstrDeviceID [in]

指定包含设备的唯一标识符的字符串。

__MIDL__IWiaMiniDrv0001

bstrRootFullItemName [in]

指定包含根项全名的字符串。

__MIDL__IWiaMiniDrv0002

lFlags [in]

保留。设置为零。

__MIDL__IWiaMiniDrv0003

pIUnknownOuter [in， optional]

(可选) 指向可接收 IUnknown 接口地址的内存位置。

__MIDL__IWiaMiniDrv0004

pStiDevice [in， optional]

指向 IStiDevice COM 接口。

__MIDL__IWiaMiniDrv0005

pWiasContext [in]

指向 WIA 项上下文的指针。

__MIDL__IWiaMiniDrv0006

plDevErrVal [out]

指向将接收此方法的状态代码的内存位置。如果此方法返回 S_OK，则存储的值将为零。否则，微型驱动程序特定的错误代码将存储在此参数指向的位置。

__MIDL__IWiaMiniDrv0007

ppIDrvItemRoot [out，可选]

指向将接收 IWiaDrvItem 接口（根项的接口）的地址的内存位置。

__MIDL__IWiaMiniDrv0008

ppIUnknownInner [out， optional]

(可选) 指向可接收 IUnknown 接口地址的内存位置。如果微型驱动程序具有无法通过 IWiaMiniDrv 接口访问的功能，则供应商可以在微型驱动程序上创建单独的接口。此参数提供对该功能的访问权限。

返回值

成功后，方法应返回 S_OK 并清除 plDevErrVal 指向的设备错误值。如果方法失败，它应返回标准 COM 错误代码，并在 plDevErrVal 指向的内存中放置一个特定于微型驱动程序的错误代码值。

plDevErrVal 指向的值可以通过调用 IWiaMiniDrv：:d rvGetDeviceErrorStr 转换为字符串。

注解

此方法应初始化任何专用结构并创建驱动程序项树。有关微型驱动程序在此方法中通常执行的步骤的详细信息，请参阅初始化 WIA 微型驱动程序和创建 WIA 驱动程序项树。

WIA 服务调用 IWiaMiniDrv：:d rvInitializeWia 方法，以响应客户端对 CreateDevice 函数的调用，这意味着每个新客户端连接都会调用此方法一次。

例如，如果用户右键单击 “我的电脑”中的 WIA 扫描仪图标，则 shell 将调用 CreateDevice，这将生成对微型驱动程序的 IWiaMiniDrv：:d rvInitializeWia 方法的 调用。如果用户随后运行 WIA 获取向导，则还会调用 CreateDevice。每次调用 CreateDevice 时，都会对微型驱动程序上的 IWiaMiniDrv：:d rvInitializeWia 方法进行相应的调用。