Interfaz IWiaItem2

La interfaz IWiaItem2 proporciona a las aplicaciones la misma funcionalidad que la interfaz IWiaItem (la capacidad de consultar dispositivos para detectar sus funcionalidades, acceder a las interfaces de transferencia de datos y las propiedades de elementos y controlar el dispositivo). También proporciona a la aplicación la capacidad de crear y usar dinámicamente filtros de procesamiento de imágenes que pueden venir como extensiones de los controladores de dispositivos windows Image Acquisition (WIA) 2.0 proporcionados en Windows Vista.

Miembros

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

Métodos

La interfaz IWiaItem2 tiene estos métodos.

Método Descripción
CheckExtension Comprueba si una extensión especificada está disponible en el equipo y la puede usar el método IWiaItem2::GetExtension .
CreateChildItem Cree un nuevo elemento secundario. Agrega objetos IWiaItem2 al árbol IWiaItem2 de un dispositivo.
DeleteItem Quita el objeto IWiaItem2 actual del árbol de objetos del dispositivo.
DeviceCommand Emite un comando a un dispositivo de hardware WIA 2.0.
DeviceDlg Muestra un cuadro de diálogo al usuario para prepararse para la adquisición de imágenes.
Diagnóstico No se admite actualmente.
EnumChildItems Crea un objeto enumerador y pasa un puntero a su interfaz IEnumWiaItem2 para carpetas con elementos en el árbol IWiaItem2 de un dispositivo WIA 2.0.
EnumDeviceCapabilities Crea un enumerador que se usa para determinar los comandos y eventos que admite un dispositivo WIA 2.0.
EnumRegisterEventInfo El método IWiaItem2::EnumRegisterEventInfo crea un enumerador que se usa para obtener información sobre los eventos para los que se registra una aplicación.
FindItemByName Busca el árbol de un elemento de subelementos con el nombre como clave de búsqueda.
GetExtension Obtiene las interfaces de extensión que pueden venir con un controlador de dispositivo WIA 2.0.
GetItemCategory Obtiene la información de categoría de un elemento.
GetItemType Obtiene la información de tipo de un elemento.
GetParentItem Obtiene el elemento primario del árbol que representa un dispositivo de hardware WIA 2.0.
GetPreviewComponent Obtiene el componente de versión preliminar de WIA 2.0.
GetRootItem Obtiene el elemento raíz de un árbol de objetos de elemento utilizados para representar un dispositivo de hardware WIA 2.0.

 

Comentarios

El árbol de elementos de WIA 2.0 que una aplicación puede ver es independiente del árbol creado y mantenido por un minidriver WIA 2.0. Cuando un minidriver crea un árbol de elementos, el servicio WIA 2.0 usa este árbol de elementos WIA 2.0 como guía para crear copias idénticas que se pueden ver mediante aplicaciones de creación de imágenes. Los elementos del árbol copiado se denominan elementos de aplicación. Los elementos del árbol creados por un minidriver se denominan elementos de controlador. En Windows Vista, los árboles de elementos WIA 2.0 se crean de objetos IWiaItem2 , cada uno de los cuales implementa la interfaz IWiaItem2 ).

La interfaz IWiaItem2 , 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 Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado
Wia.h
IDL
Wia.idl