IWiaDevMgr2::CreateDevice-Methode

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

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.

Hinweise

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. Nach 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 empfangen.

Anforderungen

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