Identificación del origen de entrada de un evento scan
Una operación de examen de inserción es una operación de examen que el usuario inicia desde un dispositivo de escáner WIA en lugar de desde la interfaz de usuario de una aplicación WIA que se ejecuta en un equipo de escritorio. Cuando el usuario presiona el botón iniciar examen en el dispositivo, la aplicación recibe un evento de examen para notificarle que el usuario ha solicitado una operación de examen. En respuesta a este evento, la aplicación puede realizar la operación de examen de inserción de una de las dos maneras siguientes:
Si el dispositivo admite el examen configurado automáticamente, la aplicación puede solicitar una transferencia de datos desde el elemento automático para adquirir una imagen del origen de entrada seleccionado actualmente (plano, alimentador automático de documentos o adaptador de escaneo de película). En respuesta, el dispositivo configura automáticamente sus opciones de examen (excepto las pocas propiedades que solo puede configurar la aplicación, que se describen en Propiedades de WIA compatibles con un elemento automático) y, a continuación, adquiere la imagen.
La aplicación puede realizar la operación de examen bajo control directo del programa. En primer lugar, la aplicación configura las propiedades del elemento WIA (elemento plano, elemento de alimentador o elemento de película) que representa el origen de entrada seleccionado actualmente. A continuación, la aplicación adquiere una imagen solicitando una transferencia de datos de este elemento.
Para obtener más información sobre los elementos de WIA, vea Categorías de elementos wia.
Cuando se produce un evento de examen, la aplicación recibe una notificación que incluye un identificador de evento WIA (un valor GUID) para especificar la naturaleza del evento. El minidriver WIA puede asignar un GUID de identificador de evento WIA personalizado a un evento o el minidriver puede usar una de las constantes GUID de WIA_EVENT_SCAN_XXX definidas en el archivo de encabezado Wiadef.h. Para obtener más información sobre estas constantes, consulte Identificadores de eventos wia.
Aunque el identificador de evento WIA de un evento de examen proporciona información sobre el evento, no identifica el origen de entrada que se va a usar para la operación de examen. Para el examen configurado automáticamente, la aplicación no necesita esta información. Sin embargo, para realizar un examen bajo el control directo del programa, la aplicación debe saber qué origen de entrada usar. La aplicación debe tener una manera de obtener esta información del dispositivo si el dispositivo tiene más de un origen de entrada y el usuario puede seleccionar el origen de entrada del dispositivo en lugar de desde la interfaz de usuario de la aplicación. Al seleccionar un origen de entrada del dispositivo, el usuario puede seleccionar el origen explícitamente (presionando un botón en el panel frontal del dispositivo) o implícitamente (por ejemplo, insertando un documento en un alimentador en el dispositivo).
Cuando se produce un evento de examen, una aplicación puede consultar la propiedad WIA_DPS_SCAN_AVAILABLE_ITEM del dispositivo del escáner WIA para identificar el origen de entrada seleccionado, si el dispositivo admite esta propiedad. WIA_DPS_SCAN_AVAILABLE_ITEM es una propiedad opcional del elemento raíz en el árbol de elementos WIA de un dispositivo. Para obtener más información sobre esta propiedad, vea WIA_DPS_SCAN_AVAILABLE_ITEM.
El controlador de clase de examen WSD implementa la propiedad WIA_DPS_SCAN_AVAILABLE_ITEM como una característica de controlador estándar, como se describe en el párrafo anterior, en lugar de como una extensión de controlador personalizada. Para obtener más información sobre el controlador de clase de examen WSD, consulte WIA with Web Services for Devices(WIA with Web Services for Devices). Para obtener más información sobre WDP para escáneres, consulte Web Services for Devices Scan Service Schema.