Метод 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 [в, необязательно]
(Необязательно) Указывает на расположение памяти, которое может получать адрес интерфейса IUnknown .
__MIDL__IWiaMiniDrv0004
pStiDevice [in, необязательный параметр]
Указывает на ИНТЕРФЕЙС COM IStiDevice.
__MIDL__IWiaMiniDrv0005
pWiasContext [in]
Указатель на контекст элемента WIA.
__MIDL__IWiaMiniDrv0006
plDevErrVal [out]
Указывает на расположение памяти, которое получит код состояния для этого метода. Если этот метод возвращает S_OK, сохраненное значение будет равно нулю. В противном случае код ошибки, относящейся к мини-накопителю, будет храниться в расположении, на которое указывает этот параметр.
__MIDL__IWiaMiniDrv0007
ppIDrvItemRoot [out, optional]
Указывает на расположение памяти, которое получит адрес интерфейса 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 в разделе "Мой компьютер", оболочка вызывает Метод CreateDevice, который создает вызов метода IWiaMiniDrv::d rvInitializeWia мини-driver. Если пользователь запускает мастер приобретения WIA, он также вызывает CreateDevice. При каждом вызове CreateDevice происходит соответствующий вызов метода IWiaMiniDrv::d rvInitializeWia в мини-driver.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wiamindr_lh.h (включая Wiamindr.h) |
См. также раздел
IWiaMiniDrv::d rvGetDeviceErrorStr