Freigeben über


IWiaDevMgr2::CreateDevice-Methode

Erstellt eine hierarchische Struktur von IWiaItem2-Objekten für ein Windows Image Acquisition (WIA) 2.0-Gerät.

Syntax

HRESULT CreateDevice(
  [in]  LONG      lFlags,
  [in]  BSTR      bstrDeviceID,
  [out] IWiaItem2 **ppWiaItem2Root
);

Parameter

lFlags [in]

Typ: LONG

Derzeit nicht verwendet. Sollte auf Null festgelegt werden.

bstrDeviceID [in]

Typ: BSTR

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

ppWiaItem2Root [out]

Typ: IWiaItem2**

Empfängt die Adresse eines Zeigers auf die IWiaItem2-Schnittstelle des Stammelements in der hierarchischen Struktur für das WIA 2.0-Gerät.

Rückgabewert

Typ: HRESULT

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

Bemerkungen

Anwendungen verwenden die IWiaDevMgr2::CreateDevice-Methode , um ein Geräteobjekt für die WIA 2.0-Geräte zu erstellen, die durch den bstrDeviceID-Parameter angegeben werden. Bei der Rückgabe speichert die IWiaDevMgr2::CreateDevice-Methode eine Adresse eines Zeigers im Parameter ppWiaItem2Root, der auf das Stammelement der Struktur von IWiaItem2-Objekten verweist, die von IWiaDevMgr2::CreateDevice erstellt wurden. Anwendungen können diese Struktur von Objekten verwenden, um Daten vom WIA 2.0-Gerät zu steuern und abzurufen.

Anwendungen müssen die IUnknown::Release-Methode für die Zeiger aufrufen, die sie über den ppWiaItem2Root-Parameter erhalten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2008 [nur Desktop-Apps]
Header
Wia.h
IDL
Wia.idl