Метод IWiaDevMgr::CreateDevice (wia_xp.h)

IWiaDevMgr::CreateDevice создает иерархическое дерево объектов IWiaItem для устройства получения образов Windows (WIA).

Синтаксис

HRESULT CreateDevice(
  [in]  BSTR     bstrDeviceID,
  [out] IWiaItem **ppWiaItemRoot
);

Параметры

[in] bstrDeviceID

Тип: BSTR

Указывает уникальный идентификатор устройства WIA.

[out] ppWiaItemRoot

Тип: IWiaItem**

Указатель на указатель на интерфейс IWiaItem корневого элемента в иерархическом дереве для устройства WIA.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Приложения используют метод IWiaDevMgr::CreateDevice для создания объекта устройства для устройств WIA, указанных параметром bstrDeviceID .

При возврате метод IWiaDevMgr::CreateDevice сохраняет адрес указателя в параметре ppWiaItemRoot. Указатель указывает на корневой элемент дерева объектов IWiaItem , созданных IWiaDevMgr::CreateDevice. Приложения могут использовать это дерево объектов для управления данными и их извлечения с устройства WIA.

Обратите внимание, что приложения должны вызывать метод IUnknown::Release для указателей, которые они получают с помощью параметра ppWiaItemRoot .

Требования

Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	wia_xp.h (включая Wia.h)
Библиотека	Wiaguid.lib
DLL	Wiaservc.dll