Freigeben über


IWiaItem::GetRootItem-Methode (wia_xp.h)

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