Compartir a través de

Método IWiaItem::GetRootItem (wia_xp.h)

  • Artículo

El método IWiaItem::GetRootItem recupera el elemento raíz de un árbol de objetos de elemento que se usa para representar un dispositivo de hardware de adquisición de imágenes de Windows (WIA).

Sintaxis

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

Parámetros

[out] ppIWiaItem

Tipo: IWiaItem**

Recibe la dirección de un puntero a la interfaz IWiaItem que contiene un puntero a la interfaz IWiaItem del elemento raíz.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Dada cualquier objeto IWiaItem en el árbol de objetos de un dispositivo de hardware WIA, la aplicación recupera un puntero al elemento raíz mediante una llamada a esta función.

Las aplicaciones deben llamar al método IUnknown::Release en los punteros de interfaz que reciben a través del parámetro ppIWiaItem .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wia_xp.h (incluye Wia.h)
Library Wiaguid.lib
Archivo DLL Wiaservc.dll