IWiaMiniDrv：:d rvInitializeWia 方法 (wiamindr_lh.h)
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]
__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 方法进行相应的调用。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | wiamindr_lh.h (包括 Wiamindr.h) |
另请参阅
IWiaMiniDrv：:d rvGetDeviceErrorStr