WIA_DPS_SCAN_AVAILABLE_ITEM
La propiedad WIA_DPS_SCAN_AVAILABLE_ITEM proporciona el nombre del origen de entrada para una operación de examen de inserción que la aplicación realiza bajo el control de programa. El minidriver WIA crea y mantiene esta propiedad.
Tipo de propiedad: VT_BSTR
Valores válidos: WIA_PROP_NONE
Derechos de acceso: solo lectura
Observaciones
En Windows 7 y versiones posteriores, WIA_DPS_SCAN_AVAILABLE_ITEM es una propiedad opcional del elemento raíz en el árbol de elementos WIA de un dispositivo de escáner WIA. Una aplicación puede consultar esta propiedad para determinar el origen de entrada (fuente plana, alimentador automático de documentos o adaptador de escaneo de película) desde el que se va a examinar o desde la ubicación de almacenamiento desde la que transferir datos.
Algunos dispositivos del escáner WIA permiten a un usuario seleccionar un origen de entrada para un trabajo de examen desde el panel frontal del dispositivo o seleccionar implícitamente un origen de entrada, por ejemplo, insertando un documento en un alimentador en el dispositivo. Cuando el usuario presiona el botón Iniciar examen en el dispositivo, la aplicación debe determinar qué origen de entrada ha seleccionado el usuario para que pueda iniciar una operación de examen en este origen.
Un evento de examen notifica a la aplicación que el usuario ha iniciado un examen, pero el evento no proporciona el nombre del elemento WIA que representa el origen de entrada. El controlador de eventos de la aplicación puede consultar la propiedad WIA_DPS_SCAN_AVAILABLE_ITEM del elemento raíz para obtener el nombre del elemento de origen de entrada.
El elemento raíz de un árbol WIA tiene uno o varios elementos secundarios (elemento plano, elemento de alimentador y elemento de película) que representan orígenes de entrada en el dispositivo. Cada uno de estos elementos puede ser un elemento primario a elementos secundarios que representan partes o regiones del origen de entrada. Un elemento plano que es un elemento secundario del elemento raíz y que representa el plano como un todo puede tener elementos secundarios (que también son elementos planos) que representan las regiones individuales de la superficie plana. Un elemento de alimentador que es un elemento secundario del elemento raíz y que representa un alimentador automático de documentos puede tener elementos secundarios que representan los escáneres para los lados frontal y trasero de las páginas del documento que pasan a través del alimentador. Un elemento de película que es un elemento secundario del elemento raíz y que representa el adaptador de escaneo de película como un todo puede tener elementos secundarios (que también son elementos de película) que representan fotogramas de película individuales. Dependiendo de la operación de examen solicitada por el usuario, la propiedad WIA_DPS_SCAN_AVAILABLE_ITEM puede asignar un nombre a un elemento plano, alimentador o de película que sea un elemento secundario de la raíz o puede asignar un nombre secundario a uno de estos elementos. Para obtener más información sobre estos elementos, vea Categorías de elementos wia.
Cuando se produce un evento de examen, el controlador establece inmediatamente el valor de la propiedad WIA_DPS_SCAN_AVAILABLE_ITEM en un nombre de elemento WIA (exactamente como indica la propiedad WIA_IPA_ITEM_NAME del elemento) que identifica el origen de entrada desde el que está disponible el trabajo de examen, si se conoce esta información. De lo contrario, si se desconoce el origen de entrada, el controlador establece el valor de propiedad en una cadena vacía. Cuando la aplicación consume el evento de examen, el estado del evento de examen cambia de señalado a no señalado y el controlador restablece el valor de la propiedad WIA_DPS_SCAN_AVAILABLE_ITEM en una cadena vacía.
Para obtener más información sobre esta propiedad, vea Identificación del origen de entrada para un evento de examen.
Requisitos
Encabezado: wiadef.h (incluya Wiadef.h)