IWiaItem2::GetRootItem-Methode

Ruft das Stammelement einer Struktur von Elementobjekten ab, die zur Darstellung eines Windows Image Acquisition (WIA) 2.0-Hardwaregeräts verwendet werden.

Syntax

HRESULT GetRootItem(
  [out] IWiaItem2 **ppIWiaItem2
);

Parameter

ppIWiaItem2 [out]

Typ: IWiaItem2**

Empfängt die Adresse eines Zeigers auf die IWiaItem2-Schnittstelle des Stammelements.

Rückgabewert

Typ: HRESULT

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

Bemerkungen

Bei jedem IWiaItem2-Objekt in der Objektstruktur eines WIA 2.0-Hardwaregeräts ruft die Anwendung einen Zeiger auf das Stammelement ab, indem diese Funktion aufgerufen wird.

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

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