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 |
|
IDL |
|