Interfaz IWiaItem (wia_xp.h)

Cada dispositivo de hardware de Windows Image Acquisition (WIA) se representa en una aplicación como un árbol jerárquico de objetos IWiaItem . La interfaz IWiaItem proporciona a las aplicaciones la capacidad de consultar dispositivos para detectar sus funcionalidades. También proporciona acceso a las interfaces de transferencia de datos y a las propiedades de elementos. Además, la interfaz IWiaItem proporciona métodos para permitir que las aplicaciones controlen el dispositivo.

Nota En el caso de las aplicaciones de Windows Vista, use IWiaItem2 en lugar de IWiaItem.

 

Herencia

La interfaz IWiaItem hereda de la interfaz IUnknown . IWiaItem también tiene estos tipos de miembros:

Métodos

La interfaz IWiaItem tiene estos métodos.

IWiaItem::AnalyzeItem El método IWiaItem::AnalyzeItem hace que el dispositivo de hardware windows Image Acquisition (WIA) adquiera e intente detectar qué tipos de datos están presentes.
IWiaItem::CreateChildItem Las aplicaciones usan el método IWiaItem::CreateChildItem para agregar objetos IWiaItem al árbol IWiaItem de un dispositivo.
IWiaItem::D eleteItem El método IWiaItem::D eleteItem quita el objeto IWiaItem actual del árbol de objetos del dispositivo.
IWiaItem::D eviceCommand IWiaItem::D eviceCommand emite un comando a un dispositivo de hardware de adquisición de imágenes de Windows (WIA).
IWiaItem::D eviceDlg Las aplicaciones usan el método IWiaItem::D eviceDlg para mostrar un cuadro de diálogo al usuario para prepararse para la adquisición de imágenes.
IWiaItem::D iagnostic No se admite este método. (IWiaItem.Diagnostic)
IWiaItem::D umpDrvItemData No se admite este método. (IWiaItem.DumpDrvItemData)
IWiaItem::D umpItemData No se admite este método. (IWiaItem.DumpItemData)
IWiaItem::D umpTreeItemData No se admite este método. (IWiaItem.DumpTreeItemData)
IWiaItem::EnumChildItems El método IWiaItem::EnumChildItems crea un objeto enumerador y pasa un puntero a su interfaz IEnumWiaItem para carpetas no vacías en un árbol IWiaItem de un dispositivo windows Image Acquisition (WIA).
IWiaItem::EnumDeviceCapabilities El método IWiaItem::EnumDeviceCapabilities crea un enumerador que se usa para determinar los comandos y eventos que admite un dispositivo windows Image Acquisition (WIA).
IWiaItem::EnumRegisterEventInfo El método IWiaItem::EnumRegisterEventInfo crea un enumerador que se usa para obtener información sobre los eventos para los que se registra una aplicación.
IWiaItem::FindItemByName El método IWiaItem::FindItemByName busca en el árbol de elementos secundarios de un elemento con el nombre como clave de búsqueda. Cada objeto IWiaItem tiene un nombre como una de sus propiedades estándar.
IWiaItem::GetItemType Las aplicaciones llaman al método IWiaItem::GetItemType para obtener la información de tipo de un elemento.
IWiaItem::GetRootItem El método IWiaItem::GetRootItem recupera el elemento raíz de un árbol de objetos de elemento usados para representar un dispositivo de hardware de adquisición de imágenes de Windows (WIA).

Comentarios

Algunos de los métodos de la interfaz IWiaItem solo son válidos en el elemento raíz del árbol del dispositivo. Otros métodos son válidos en todos los elementos. Los métodos se agrupan de la siguiente manera:

Válido solo en el elemento raíz	IWiaItem::D eviceCommand
	IWiaItem::D eviceDlg
	IWiaItem::EnumDeviceCapabilities
	IWiaItem::EnumRegisterEventInfo
Válido en todos los elementos	IWiaItem::AnalyzeItem
	IWiaItem::CreateChildItem
	IWiaItem::D eleteItem
	IWiaItem::EnumChildItems
	IWiaItem::FindItemByName
	IWiaItem::GetItemType
	IWiaItem::GetRootItem

 

La interfaz IWiaItem , como todas las interfaces del Modelo de objetos componentes (COM), hereda los métodos de interfaz IUnknown .

Métodos IUnknown	Descripción
IUnknown::QueryInterface	Devuelve punteros a las interfaces compatibles.
IUnknown::AddRef	Incrementa el recuento de referencias.
IUnknown::Release	Reduce el recuento de referencias.

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 (incluya Wia.h)