IWiaItem::GetRootItem-Methode (wia_xp.h)

Artikel
03/03/2024

Die IWiaItem::GetRootItem-Methode ruft das Stammelement einer Struktur von Elementobjekten ab, die verwendet werden, um ein WIA-Hardwaregerät (Windows Image Acquisition) darzustellen.

Syntax

HRESULT GetRootItem(
  [out] IWiaItem **ppIWiaItem
);

Parameter

[out] ppIWiaItem

Typ: IWiaItem**

Empfängt die Adresse eines Zeigers auf die IWiaItem-Schnittstelle , die einen Zeiger auf die IWiaItem-Schnittstelle des Stammelements enthält.

Rückgabewert

Typ: HRESULT

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

Hinweise

Bei jedem IWiaItem-Objekt in der Objektstruktur eines WIA-Hardwaregeräts ruft die Anwendung durch Aufrufen dieser Funktion einen Zeiger auf das Stammelement ab.

Anwendungen müssen die IUnknown::Release-Methode für die Schnittstellenzeiger aufrufen, die sie über den ppIWiaItem-Parameter empfangen.

Anforderungen

Anforderung	Wert
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 (wia.h einschließen)
Bibliothek	Wiaguid.lib
DLL	Wiaservc.dll

Freigeben über