IWiaItem ::GetRootItem, méthode (wia_xp.h)

La méthode IWiaItem ::GetRootItem récupère l’élément racine d’une arborescence d’objets d’élément utilisés pour représenter un périphérique matériel d’acquisition d’images Windows (WIA).

Syntaxe

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

Paramètres

[out] ppIWiaItem

Type : IWiaItem**

Reçoit l’adresse d’un pointeur vers l’interface IWiaItem qui contient un pointeur vers l’interface IWiaItem de l’élément racine.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Étant donné n’importe quel objet IWiaItem dans l’arborescence d’objets d’un périphérique matériel WIA, l’application récupère un pointeur vers l’élément racine en appelant cette fonction.

Les applications doivent appeler la méthode IUnknown ::Release sur les pointeurs d’interface qu’elles reçoivent via le paramètre ppIWiaItem .

Configuration requise