IWiaDevMgr::CreateDevice-Methode (wia_xp.h)

Artikel
08/27/2023

IWiaDevMgr::CreateDevice erstellt eine hierarchische Struktur von IWiaItem-Objekten für ein Windows Image Acquisition-Gerät (WIA).

Syntax

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

Parameter

[in] bstrDeviceID

Typ: BSTR

Gibt den eindeutigen Bezeichner des WIA-Geräts an.

[out] ppWiaItemRoot

Typ: IWiaItem**

Zeiger auf einen Zeiger auf die IWiaItem-Schnittstelle des Stammelements in der hierarchischen Struktur für das WIA-Gerät.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Anwendungen verwenden die IWiaDevMgr::CreateDevice-Methode , um ein Geräteobjekt für die WIA-Geräte zu erstellen, die durch den bstrDeviceID-Parameter angegeben werden.

Wenn sie zurückgegeben wird, speichert die IWiaDevMgr::CreateDevice-Methode eine Adresse eines Zeigers im Parameter ppWiaItemRoot. Der Zeiger zeigt auf das Stammelement der Struktur der IWiaItem-Objekte , die von IWiaDevMgr::CreateDevice erstellt wurden. Anwendungen können diese Struktur von Objekten verwenden, um Daten vom WIA-Gerät zu steuern und abzurufen.

Beachten Sie, dass Anwendungen die IUnknown::Release-Methode für die Zeiger aufrufen müssen, die sie über den ppWiaItemRoot-Parameter empfangen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wia_xp.h (einschließlich Wia.h)
Bibliothek	Wiaguid.lib
DLL	Wiaservc.dll

Freigeben über