Categorías de elementos wia

Este tema se aplica a Windows Vista y versiones posteriores.

Todos los elementos de un árbol de elementos WIA deben admitir la propiedad WIA_IPA_ITEM_CATEGORY . Esta propiedad identifica la categoría funcional a la que pertenece un elemento. La categoría determina el conjunto de marcas de elementos wia y propiedades de WIA asociadas al elemento.

WIA define las siguientes categorías de elementos:

WIA_CATEGORY_ROOT
El elemento raíz del árbol de elementos de un dispositivo de escáner WIA representa el dispositivo en su conjunto. Si el dispositivo incluye una función de digitalización plana, ADF o película, los elementos que representan estos orígenes de entrada son elementos secundarios del elemento raíz. Si el dispositivo contiene almacenamiento, el elemento de carpeta más alto de la jerarquía de almacenamiento del dispositivo es un elemento secundario del elemento raíz. Una aplicación puede acceder a la información sobre el dispositivo, incluidos el estado, la identificación y los derechos de acceso, a través de las propiedades de WIA implementadas en el elemento raíz. Para obtener más información, vea las discusiones sobre las propiedades del elemento raíz en Implementación de árboles de elementos del escáner plano, Implementación de árboles de elementos del escáner de alimentador e Implementación de árboles de elementos del escáner de película.

WIA_CATEGORY_FLATBED
Un elemento plano representa un escáner plano (también denominado placa de digitalización) en un dispositivo de escáner WIA. El árbol de elementos WIA para un dispositivo con un examen plano debe incluir un elemento plano que sea un elemento secundario del elemento raíz. Además, si el dispositivo WIA admite la segmentación (por ejemplo, por un filtro de segmentación) o el examen de varias regiones, este elemento plano debe tener elementos secundarios, que también son elementos planos, para representar las regiones de examen individuales en el plano. Los elementos secundarios, cuando están presentes, deben pertenecer a la misma categoría WIA_CATEGORY_FLATBED que su elemento primario, y deben admitir las mismas propiedades wia (y tener los mismos valores de propiedad iniciales) que sus elementos primarios, excepto que las posiciones y extensiones de los elementos secundarios se limitan a las regiones de examen que representan. Una aplicación puede usar el filtro de segmentación del controlador WIA (si se proporciona uno) para crear regiones de examen o el minidriver puede detectar y crear automáticamente las regiones de examen. Una aplicación puede acceder a la función de escaneo plano del dispositivo a través de las propiedades WIA implementadas en el elemento plano (o elementos). Para obtener más información, vea Implementar árboles de elementos del escáner plano.

WIA_CATEGORY_FEEDER
Un elemento de alimentador representa un alimentador automático de documentos (ADF) en un dispositivo de escáner WIA. (Esta categoría de elemento también puede representar un alimentador que no es totalmente automático y que requiere asistencia manual del usuario, pero, en este caso, el minidriver WIA es responsable de comprobar que la página del documento siguiente ha avanzado a través del alimentador antes de examinar la página). Un dispositivo con ADF debe incluir un elemento de alimentador en su árbol de elementos WIA. Un elemento de alimentador es un elemento secundario del elemento raíz. Una aplicación puede acceder a la función de análisis de ADF del dispositivo a través de las propiedades de WIA implementadas en el elemento de alimentador. Para obtener más información, vea Implementación de árboles de elementos del analizador de alimentadores.

Si la ADF puede realizar un análisis dúplex (es decir, examinar ambos lados de una página de documento) y admite diferentes configuraciones de control para examinar los lados frontal y posterior de las páginas del documento, el minidriver WIA debe implementar un elemento frontal del alimentador y un elemento de retroceso del alimentador como elementos secundarios del elemento de alimentador. Una aplicación puede acceder a las funciones de análisis frontal y trasero de ADF a través de las propiedades de WIA implementadas en el elemento frontal del alimentador y en el elemento de retroceso del alimentador. Para obtener más información sobre estos dos elementos, vea las siguientes descripciones de categorías.

WIA_CATEGORY_FEEDER_FRONT
Un elemento frontal del alimentador representa la configuración de ADF para examinar el lado frontal de las páginas de un documento. El minidriver WIA debe implementar este elemento para un dispositivo de escáner que tiene una ADF que puede realizar un escaneo dúplex y que admite diferentes configuraciones de control para examinar los lados frontal y trasero de las páginas del documento. Un dispositivo que tenga una instancia de ADF que siempre use la misma configuración para ambos lados de las páginas del documento no necesita este elemento. Un elemento frontal del alimentador es un elemento secundario de un elemento de alimentador. Una aplicación puede acceder a la función de examen frontal de ADF a través de las propiedades de WIA implementadas en el elemento frontal del alimentador. Para obtener más información, vea Implementación de árboles de elementos del analizador de alimentadores.

WIA_CATEGORY_FEEDER_BACK
Un elemento de retroceso del alimentador representa la configuración de ADF para examinar el lado posterior de las páginas de un documento. El minidriver WIA debe implementar este elemento para un dispositivo de escáner que tiene una ADF que puede realizar un escaneo dúplex y que admite diferentes configuraciones de control para examinar los lados frontal y trasero de las páginas del documento. Un dispositivo que tenga una instancia de ADF que siempre use la misma configuración para ambos lados de las páginas del documento no necesita este elemento. Un elemento de retroceso del alimentador es un elemento secundario de un elemento de alimentador. Una aplicación puede acceder a la función de análisis de reserva de ADF a través de las propiedades de WIA implementadas en el elemento de retroceso del alimentador. Para obtener más información, vea Implementación de árboles de elementos del analizador de alimentadores.

WIA_CATEGORY_FILM
Un elemento de película representa una función de escaneo de película en un dispositivo de escáner WIA. Un dispositivo que sea un escáner de película dedicado o que sea un escáner plano equipado con un adaptador de transparencia (TPA), debe incluir uno o más elementos de película en su árbol de elementos WIA. Un elemento de película es un elemento secundario del elemento raíz o de otro elemento de película. Un elemento de película que es un elemento secundario del elemento raíz representa toda la superficie de exploración, y este elemento de película puede tener elementos secundarios que representan las regiones de la superficie de exploración que corresponden a fotogramas de película individuales. Una aplicación puede acceder a la función de escaneo de película del dispositivo a través de las propiedades WIA implementadas en el elemento de película (o elementos). Para obtener más información, vea Implementar árboles de elementos del escáner de película.

WIA_CATEGORY_FOLDER
Un elemento de carpeta representa una carpeta ubicada en el almacenamiento interno del dispositivo del escáner WIA. Un elemento de carpeta es un elemento secundario del elemento raíz o de otro elemento de carpeta. Si un elemento de carpeta tiene elementos secundarios, los elementos secundarios son una combinación de elementos de archivo terminados y elementos de carpeta. El elemento de carpeta superior de un árbol de elementos es un elemento secundario del elemento raíz. Una aplicación puede acceder al contenido de la carpeta e información sobre la carpeta a través de las propiedades de WIA implementadas en el elemento de carpeta. Para obtener más información, consulte WiA Scanner Storage.

WIA_CATEGORY_FINISHED_FILE
Un elemento de archivo terminado representa un archivo terminado almacenado en una carpeta en un dispositivo de escáner WIA. Un archivo terminado es un archivo cuyo contenido no cambiará. Esta definición excluye los archivos cuyo contenido puede cambiar dinámicamente, por ejemplo, a medida que el analizador adquiere y procesa los datos de imagen. Un elemento de archivo terminado es un elemento secundario de un elemento de carpeta. Una aplicación puede acceder a un archivo terminado e información sobre el archivo a través de las propiedades wia implementadas en el elemento de archivo finalizado. Para obtener más información, consulte WiA Scanner Storage.

WIA_CATEGORY_AUTO
En Windows 7 y versiones posteriores, un elemento automático representa las opciones de configuración automática de un dispositivo de escáner WIA que admite el examen configurado automáticamente. Este tipo de dispositivo puede configurar sus propias opciones de examen en lugar de requerir que una aplicación wia se configure en un equipo de escritorio. Por ejemplo, si el dispositivo permite al usuario iniciar una operación de examen desde el dispositivo (en lugar de desde la interfaz de usuario de la aplicación) y seleccionar el origen de entrada para la operación desde el dispositivo, la aplicación puede usar el elemento automático para descargar, en el dispositivo, la tarea de configurar el origen de entrada seleccionado. Un elemento automático es un elemento secundario del elemento raíz. Un árbol WIA que contenga un elemento automático también debe contener uno o varios de los siguientes elementos: elemento plano, elemento de alimentador o elemento de película. Una aplicación puede acceder a la función de examen configurada automáticamente de un dispositivo a través de las propiedades wia implementadas en el elemento raíz y en el elemento automático. Para obtener más información, vea Propiedades de WIA compatibles con un elemento automático.

Cada categoría de elemento wia tiene un conjunto de marcas de elementos wia necesarias y propiedades wia que un elemento de la categoría debe admitir y, además, un conjunto de marcas y propiedades que el elemento puede admitir como opciones. Para obtener un resumen de las marcas y propiedades asociadas a las distintas categorías de elementos, vea WIA_IPA_ITEM_CATEGORY. Para obtener una lista completa de las marcas de elementos wia, consulte WIA_IPA_ITEM_FLAGS.