Compartir a través de

Constantes de propiedad del dispositivo del escáner

  • Artículo

Los dispositivos de hardware de adquisición de imágenes de Windows (WIA) tienen valores de propiedad almacenados en el Registro de Windows. Para obtener más información, vea Constantes de propiedad de dispositivo comunes. Las siguientes constantes de propiedad del dispositivo, con sus cadenas asociadas, son específicas de los escáneres de imágenes digitales.

El prefijo "WIA_DPS_" indica una propiedad device para dispositivos scanner y es la convención de nomenclatura que se usa en C/C++. Con fines de scripting, estas constantes usan el prefijo "ScannerDevice" y forman parte del tipo enumerado WiaItemPropertyId . El nombre de miembro correspondiente de esa enumeración de script aparece entre paréntesis junto al nombre de constante de C/C++ en la lista siguiente.

Constante o valor Descripción
WIA_DPS_DEVICE_ID
ScannerDeviceDeviceId
 Nota:
Esta propiedad solo se admite en Windows Vista y versiones posteriores.


Contiene un identificador de instancia de función único para un dispositivo de escáner de servicios web. Este identificador representa el servicio web en el dispositivo del escáner con el que se comunica el minicontrolador WIA. No se deben realizar suposiciones sobre la forma de este identificador. El minicontrolador WIA crea y mantiene esta propiedad.
Las aplicaciones WIA pueden usar el valor de WIA_DPS_DEVICE_ID para buscar, mediante function Discovery API, el objeto de instancia de función que representa el dispositivo de escáner de servicios web usado en la sesión de WIA 2.0 actual.
Tipo: VT_BSTR, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_DITHER_PATTERN_DATA
 Reservado, no use.
Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_DITHER_SELECT
 Reservado, no use.
Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES
ScannerDeviceDocumentHandlingCapabilities
 Contiene las funciones del analizador. El minidriver crea y mantiene esta propiedad.
Una aplicación lee esta propiedad para determinar si el escáner tiene instalado un alimentador de documentos, un alimentador de documentos o un dúplex. Esta propiedad también se usa para definir aún más las características instaladas.
Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
En la tabla siguiente se describen las constantes que son válidas solo con Windows 7.
Marcas Descripción
AUTO_SOURCE El escáner tiene instalado un controlador de documentos automático.

 

En la tabla siguiente se describen las constantes que son válidas solo con Windows 7 y Windows Vista.

Marcas Descripción
ADVANCED_DUP El dispositivo admite la configuración avanzada del examen dúplex. Use WIA_IPS_DUPLEX_SETTINGS para cambiar entre el uso de configuraciones dúplex básicas y avanzadas.
DETECT_FILM_TPA El escáner puede detectar cuándo el adaptador de transparencia o película está listo para escanear.
DETECT_STOR El analizador puede detectar cuándo hay documentos en el almacenamiento interno.
FILM_TPA El escáner está equipado con un adaptador de digitalización de transparencia/película.
STOR El escáner está equipado con un dispositivo de almacenamiento de imágenes interno.

 

En la tabla siguiente se describen las constantes que son válidas con Windows XP o posterior.

Marcas Descripción
DETECT_FEED El escáner puede detectar un documento en el alimentador.
DETECT_FLAT El escáner puede detectar un documento en la placa plana.
DETECT_SCAN El escáner solo puede detectar un documento en el alimentador mediante el examen.
DUP El escáner tiene un dúplex.
ALIMENTAR El escáner tiene instalado un controlador de documentos automático.
PLANA El escáner tiene una placa plana.

 

En la tabla siguiente se describen las constantes que son válidas solo con Windows XP. Estos valores han quedado en desuso para Windows 7 y Windows Vista y no deben usarse.

Marcas Descripción
DETECT_DUP El escáner puede detectar una solicitud de examen dúplex del usuario.
DETECT_DUP_AVAIL El escáner puede indicar cuándo está instalado el dúplex.
DETECT_FEED_AVAIL El escáner puede indicar cuándo está instalado el alimentador automático de documentos.

 
WIA_DPS_DOCUMENT_HANDLING_SELECT
ScannerDeviceDocumentHandlingSelect

Nota:
Esta propiedad no se admite en Windows Vista y versiones posteriores. Use WIA_IPS_DOCUMENT_HANDLING_SELECT.

 

Contiene el origen y el modo de adquisición del analizador actual. El minidriver crea y mantiene esta propiedad.

Una aplicación lee esta propiedad para determinar el origen de adquisición actual del analizador o para escribir esta propiedad para establecer el origen y el modo del analizador. Además, las aplicaciones usan esta propiedad para habilitar y deshabilitar la funcionalidad dúplex.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_FLAG

La tabla siguiente tiene las diez constantes que son válidas con esta propiedad.

Marcas Descripción
ALIMENTADOR Examinar mediante el alimentador de documentos.
PLANA Escanear con la cama plana.
DUPLEX Examen mediante operaciones dúplex.
AUTO_ADVANCE Habilita la alimentación automática del siguiente documento después de un examen.
FRONT_FIRST Examine primero la parte frontal del documento. Este valor es válido cuando se establece DUPLEX.
BACK_FIRST Examine primero la parte posterior del documento. Este valor es válido cuando se establece DUPLEX.
FRONT_ONLY Escanear solo el frente. Este valor es válido cuando se establece DUPLEX.
BACK_ONLY Escanee solo la espalda. Este valor es válido cuando se establece DUPLEX.
NEXT_PAGE Examine la página siguiente del documento.
PREFEED Habilite el modo de fuente previa. Posición previa al siguiente documento durante el examen.

 
WIA_DPS_DOCUMENT_HANDLING_STATUS
ScannerDeviceDocumentHandlingStatus

Contiene el estado actual de la cama plana instalada del escáner, alimentador de documentos o dúplex. El minidriver crea y mantiene esta propiedad.

Una aplicación lee esta propiedad para determinar si el dispositivo del escáner está listo para usarse. Esta es una manera ideal de comprobar si el papel está en el alimentador antes de adquirir una imagen.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE

En la tabla siguiente se muestran las constantes que son válidas con esta propiedad. Un asterisco * indica que la marca no se admite en Windows Vista o posterior. El símbolo V indica que la marca solo se admite en Windows Vista y versiones posteriores.

Marcas Descripción
FEED_READY La cama plana está lista para su uso.
FLAT_READY El escáner tiene un documento en la placa plana.
DUP_READY El dúplex está habilitado y listo para usarse.
FLAT_COVER_UP La cubierta de la cama plana está arriba.
PATH_COVER_UP La ruta de acceso del papel está cubierta y está evitando el funcionamiento adecuado.
PAPER_JAM Un documento está atascado en el alimentador de documentos.
FILM_TPA_READYV El adaptador de transparencia está instalado y listo para su uso.
STORAGE_READYV El dispositivo de almacenamiento interno está listo.
STORAGE_FULLV El almacenamiento está lleno, no es posible realizar ninguna operación de carga.
MULTIPLE_FEEDV Se produjo una condición de fuente múltiple (normalmente con un PAPER_JAM).
DEVICE_ATTENTIONV Hay un error que requiere la intervención del usuario en el dispositivo.
LAMP_ERRV El escáner no está listo debido a un problema de lámpara.

 
WIA_DPS_ENDORSER_CHARACTERS
ScannerDeviceEndorserCharacters

Contiene todos los caracteres válidos que una aplicación puede usar para crear cadenas de aprobador válidas. Un aprobador es una impresora instalada en un escáner que imprime un mensaje de texto en cada página escaneada. El minidriver debe validar el valor de la propiedad WIA_DPS_ENDORSER_STRING con el juego de caracteres válido en esta propiedad. El minidriver crea y mantiene esta propiedad.

Tipo: VT_BSTR, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_ENDORSER_STRING
ScannerDeviceEndorserString

Contiene una cadena que se va a aprobar (es decir, imprimir) en cada página que examina el minidriver. Una aplicación establece esta propiedad utilizando el juego de caracteres válido que se notifica en la propiedad WIA_DPS_ENDORSER_CHARACTERS . El minidriver solo debe aprobar documentos si se establece una cadena en esta propiedad. Una cadena vacía significa que la funcionalidad del aprobador está deshabilitada.

Dado que es responsabilidad del conductor interpretar la cadena del aprobador, el controlador puede usar caracteres especiales en WIA_DPS_ENDORSER_STRING. Sin embargo, solo las aplicaciones entenderían estos caracteres.

Tipo: VT_BSTR, Access: Lectura y escritura, Valores válidos: WIA_PROP_NONE

Un controlador que admita la propiedad WIA_DPS_ENDORSER_STRING debe admitir la siguiente lista de tokens.

Token Descripción
$DATE$ Fecha en el formulario AAAA/MM/DD.
$DAY$ El día en el formulario DD.
$MONTH$ Mes del año con el formato MM.
$PAGE_COUNT$ Número de páginas transferidas.
$TIME$ La hora del día con el formato HH:MM:SS.
$YEAR$ El año en forma AAAA.

 
WIA_DPS_FILTER_SELECT

Reservado, no use.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_GLOBAL_IDENTITY
ScannerDeviceGlobalIdentity

Nota:
Esta propiedad solo se admite en Windows Vista y versiones posteriores.

 

Contiene la dirección SOAP de un dispositivo de escáner de servicios web. El minicontrolador WIA 2.0 crea y mantiene esta propiedad.

Tipo: VT_BSTR, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_HORIZONTAL_BED_REGISTRATION
ScannerDeviceHorizontalBedRegistration

Nota:
Esta propiedad no es compatible con Windows Vista y versiones posteriores.

 

Contiene el registro, o alineación horizontal, para los documentos colocados en el plano. El minidriver crea y mantiene esta propiedad.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE

La tabla siguiente tiene las tres constantes que son válidas con esta propiedad.

Constante Descripción
LEFT_JUSTIFIED El papel está justificado.
CENTRADO El papel está centrado.
RIGHT_JUSTIFIED El papel está justificado.

 

Vea también

WIA_DPS_VERTICAL_BED_REGISTRATION
WIA_DPS_HORIZONTAL_BED_SIZE
ScannerDeviceHorizontalBedSize

Nota:
Esta propiedad no es compatible con Windows Vista y versiones posteriores. Use WIA_IPS_MAX_HORIZONTAL_SIZE.

 

Especifica el ancho máximo, en milésimas de pulgada, que se examina en el eje horizontal (X) desde la placa de un escáner plano en la resolución actual. Esta propiedad también se aplica a los alimentadores automáticos de documentos que mueven hojas a la plancha de un escáner plano para el escaneo. Esta propiedad es obligatoria para escáneres que tienen una plancha. En su lugar, otros tipos de escáner implementarán la propiedad WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE .

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceHorizontalSheetFeedSize

Nota:
Esta propiedad no es compatible con Windows Vista y versiones posteriores. Use WIA_IPS_MAX_HORIZONTAL_SIZE.

 

Especifica el ancho máximo, en milésimas de pulgada, que se examina en el eje horizontal (X) desde un escáner de alimentación manual o de hoja en la resolución actual. Esta propiedad también se aplica a los alimentadores automáticos de documentos que examinan sin mover hojas a la plancha de un escáner plano. Esta propiedad es obligatoria para escáneres con alimentación de hojas, de desplazamiento y de mano.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_MAX_SCAN_TIME
ScannerDeviceMaxScanTime

Contiene el tiempo máximo para examinar una sola página con la configuración de propiedad actual, en milisegundos. Una aplicación lee esta propiedad para calcular el tiempo que tardará en examinar una página. Esto resulta útil al determinar las condiciones de un dispositivo que ha dejado de responder. El minidriver crea y mantiene esta propiedad. Esta propiedad es necesaria para todos los escáneres.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceMinHorizontalSheetFeedSize

Nota:
Esta propiedad no es compatible con Windows Vista y versiones posteriores. Use WIA_IPS_MIN_HORIZONTAL_SIZE.

 

Contiene las dimensiones horizontales físicas de la página más pequeña que el alimentador de documentos del escáner puede escanear, en milésimas de pulgada. El minidriver crea y mantiene esta propiedad.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE

Vea también

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceMinVerticalSheetFeedSize

Nota:
Esta propiedad no es compatible con Windows Vista y versiones posteriores. Use WIA_IPS_MIN_VERTICAL_SIZE.

 

Contiene las dimensiones verticales físicas de la página más pequeña que el alimentador de documentos del escáner puede examinar, en milésimas de pulgada. El minidriver crea y mantiene esta propiedad.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE

Vea también

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
WIA_DPS_OPTICAL_XRES
ScannerDeviceOpticalXres

Nota:
Windows Vista no admite esta propiedad. Use WIA_IPS_OPTICAL_XRES.

 

Resolución óptica horizontal. Resolución óptica horizontal más alta admitida en PPP. Esta propiedad es un valor único. Esta no es una lista de todas las resoluciones que el dispositivo puede generar. En su lugar, esta es la resolución de la óptica del dispositivo. El minidriver crea y mantiene esta propiedad. Esta propiedad es necesaria para todos los escáneres.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_OPTICAL_YRES
ScannerDeviceOpticalYres

Nota:
Windows Vista no admite esta propiedad. Use WIA_IPS_OPTICAL_YRES.

 

Resolución óptica vertical. Resolución óptica vertical más alta admitida en PPP. Esta propiedad es un valor único. Esta no es una lista de todas las resoluciones generadas por el dispositivo. En su lugar, esta es la resolución de la óptica del dispositivo. El minidriver crea y mantiene esta propiedad. Esta propiedad es necesaria para todos los escáneres.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_ORIENTATION
ScannerDeviceOrientation

Contiene la configuración de orientación actual. El minidriver crea y mantiene esta propiedad.

Una aplicación establece la propiedad WIA_DPS_ORIENTATION para definir la orientación original de una página o imagen que se va a adquirir. Para obtener información sobre cómo usar WIA_DPS_ORIENTATION, consulte WIA_DPS_PAGE_SIZE

Tipo: VT_I4, Acceso: Lectura y escritura, Valores válidos: WIA_PROP_LIST

La tabla siguiente tiene las cuatro constantes que son válidas con esta propiedad.

Value Defination
HORIZONTAL Rotación en sentido contrario a las agujas del reloj de 90 grados, en relación con la orientación VERTICAL.
RETRATO 0 grados.
ROT180 Rotación en sentido contrario a las agujas del reloj de 180 grados, en relación con la orientación VERTICAL.
ROT270 Rotación en sentido contrario a las agujas del reloj de 270 grados, en relación con la orientación VERTICAL.

 

Vea también

WIA_IPS_ROTATION
WIA_DPS_PAD_COLOR
ScannerDevicePadColor

Color usado para rellenar cuando no hay suficientes datos de imagen para rellenar un búfer solicitado. Esta propiedad se implementa para escáneres que rellenan el búfer. Esta propiedad es opcional para todos los escáneres. El minidriver crea y mantiene esta propiedad.

Tipo: VT_UI1 VT_VECTOR | , Access: Solo lectura, Valores válidos: WIA_PROP_NONE

El formato de la información de color es RGBQUAD.
WIA_DPS_PAGE_HEIGHT
ScannerDevicePageHeight

Nota:
Windows Vista no admite esta propiedad. Use WIA_IPS_PAGE_HEIGHT.

 

Contiene el alto, en milésimas de pulgada, de la página seleccionada actualmente. El minidriver crea y mantiene la propiedad WIA_DPS_PAGE_HEIGHT . Una aplicación lee esta propiedad para determinar las dimensiones físicas de la página que se examinan. Si la configuración de extensión es diferente de los tamaños de página conocidos, esta propiedad informa del alto de la página cuya propiedad WIA_DPS_PAGE_SIZE se establece en WIA_PAGE_CUSTOM (que es un valor de la propiedad WIA_DPS_PAGE_SIZE ). WIA_DPS_PAGE_HEIGHT debe estar sincronizado con WIA_IPS_XEXTENT, que informa del alto, en píxeles, de la página que se va a examinar.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_PAGE_SIZE
ScannerDevicePageSize

Nota:
Windows Vista no admite esta propiedad. Use WIA_IPS_PAGE_SIZE.

 

Contiene el tamaño de la página que está seleccionada actualmente para examinarse. Para seleccionar las dimensiones de la página que se van a examinar, una aplicación establece esta propiedad. El minidriver crea y mantiene esta propiedad.

Tipo: VT_I4, Acceso: Lectura y escritura, Valores válidos: WIA_PROP_LIST

La tabla siguiente tiene las tres constantes que son válidas con esta propiedad.

Value Definición
WIA_PAGE_A4 8267 X 11692 (orientación VERTICAL)
WIA_PAGE_CUSTOM Definido por los valores de las propiedades WIA_DPS_PAGE_HEIGHT y WIA_DPS_PAGE_WIDTH
WIA_PAGE_LETTER 8500 X 11000 (orientación VERTICAL)

 

El valor de la propiedad WIA_IPS_ORIENTATION determina la orientación de la página seleccionada actualmente. Las propiedades WIA_DPS_PAGE_WIDTH y WIA_DPS_PAGE_HEIGHT notifican las dimensiones de la página, en milésimas de pulgada. Tenga en cuenta que estas propiedades deben estar en acuerdo con WIA_IPS_XEXTENT y WIA_IPS_YEXTENT, que contienen las dimensiones de la página en píxeles. Los valores válidos de tipo WIA_PROP_LIST deben depender de la configuración válida de la propiedad WIA_IPS_ORIENTATION . Si el dispositivo no puede examinar documentos orientados a horizontal con una configuración de WIA_PAGE_A4, WIA_PAGE_A4 no debe aparecer en la lista de valores válidos para la propiedad WIA_DPS_PAGE_SIZE cuando WIA_IPS_ORIENTATION se establece en LANSCAPE.

Si una aplicación establece WIA_DPS_PAGE_SIZE en cualquier valor distinto de WIA_PAGE_CUSTOM, el minidriver debe ajustar los valores de WIA_DPS_PAGE_WIDTH y WIA_DPS_PAGE_HEIGHT a las dimensiones de la página en milésimas de pulgada. También debe ajustar los valores de WIA_IPS_XEXTENT y WIA_IPS_YEXTENT a las dimensiones de la página en píxeles.

Si se cambia una configuración de extensión (WIA_IPS_XEXTENT o WIA_IPS_YEXTENT) a un valor que no coincide con la configuración actual de tamaño de página, el minidriver debe cambiar el valor de la propiedad WIA_DPS_PAGE_SIZE a WIA_PAGE_CUSTOM. El minidriver también debe modificar WIA_DPS_PAGE_WIDTH o WIA_DPS_PAGE_HEIGHT de acuerdo con la nueva configuración de extensión.

Si WIA_IPS_ORIENTATION se establece en LANSCAPE, la configuración de extensión será "volteada". Por ejemplo, si una aplicación establece WIA_DPS_PAGE_SIZE en WIA_PAGE_A4, el minidriver debe establecer WIA_DPS_PAGE_WIDTH en 11692 y WIA_DPS_PAGE_HEIGHT en 8267. (El minidriver también debe establecer WIA_IPS_XEXTENT y WIA_IPS_YEXTENT en consecuencia). Tenga en cuenta que si WIA_DPS_PAGE_SIZE se establece en WIA_PAGE_CUSTOM, la configuración de orientación no se usa para determinar las dimensiones de extensión de la página que se van a examinar.

El minidriver es responsable de garantizar que la propiedad WIA_IPS_ORIENTATION está de acuerdo con el área de selección actual. Si una aplicación cambia el valor de WIA_IPS_ORIENTATION a uno que no es válido para el tamaño de página seleccionado actualmente, el minidriver debe cambiar el valor de WIA_DPS_PAGE_SIZE a un tamaño de página compatible con el nuevo valor de orientación.

Si una aplicación establece la propiedad WIA_DPS_PAGE_SIZE en WIA_PAGE_CUSTOM, el área de selección actual no se ve afectada. El minidriver WIA debe obtener el diseño de imagen actual, empezando por la configuración actual de las propiedades WIA_IPS_XPOS y WIA_IPS_YPOS . Si la configuración de tamaño de página da como resultado un área de selección que está fuera de la cama del escáner, el minidriver debe ajustar automáticamente los valores de la WIA_IPS_XPOS y WIA_IPS_YPOS propiedades a valores válidos. Si las propiedades WIA_DPS_PAGE_SIZE y WIA_IPS_ORIENTATION se establecen al mismo tiempo y no son válidas cuando se aplican en combinación, el minidriver debe producir un error en la configuración de la aplicación devolviendo un error en IWiaMiniDrv::d rvValidateItemProperties. .

En los cuatro ejemplos siguientes se muestran diferentes escenarios de WIA_DPS_PAGE_SIZE .

  1. El controlador informa de la configuración.
  2. Una aplicación establece la propiedad WIA_DPS_PAGE_SIZE en WIA_PAGE_LETTER.
  3. Una aplicación establece la propiedad WIA_IPS_ORIENTATION en LANSCAPE.
  4. Una aplicación cambia la propiedad WIA_IPS_XEXTENT a un valor más pequeño.

Ejemplo 1: El minidriver informa de la configuración

En el ejemplo siguiente, el minidriver establece un área de selección personalizada antes de que una aplicación establezca las propiedades de WIA. En este caso, el área de selección representa todo el plano.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_WIDTH = 11500
WIA_DPS_PAGE_HEIGHT = 14000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1150
WIA_IPS_YEXTENT = 1400
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Ejemplo 2: Una aplicación establece la propiedad WIA_DPS_PAGE_SIZEen WIA_PAGE_LETTER

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_WIDTH = 8500
WIA_DPS_PAGE_HEIGHT = 11000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 850
WIA_IPS_YEXTENT = 1100
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Ejemplo 3: Una aplicación establece la propiedad WIA_IPS_ORIENTATIONen LANSCAPE

La cama física debe ser capaz de adquirir una página que originalmente estaba en orientación horizontal.

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_HEIGHT = 11000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1100
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Ejemplo 4: Una aplicación cambia la propiedad WIA_IPS_XEXTENTa un valor más pequeño

En el ejemplo siguiente, una aplicación cambia la propiedad WIA_IPS_XEXTENT a 1000. El minidriver debe suponer que el nuevo valor contenido en WIA_IPS_XEXTENT ya no es válido para la propiedad WIA_DPS_PAGE_SIZE y, por tanto, debe cambiar WIA_DPS_PAGE_SIZE a WIA_PAGE_CUSTOM. El minidriver también debe ajustar WIA_DPS_PAGE_WIDTH.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_HEIGHT = 10000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1000
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100
WIA_DPS_PAGE_WIDTH
ScannerDevicePageWidth

Nota:
Windows Vista no admite esta propiedad. Use WIA_IPS_PAGE_WIDTH.

 

Contiene el ancho de la página actual seleccionada, en milésimas de pulgada. Una aplicación lee esta propiedad para determinar las dimensiones físicas de la página que se examinan. Si la configuración de extensión es diferente de los tamaños de página conocidos, esta propiedad informa del ancho de la página cuya propiedad de WIA_DPS_PAGE_SIZE se establece en WIA_PAGE_CUSTOM. WIA_DPS_PAGE_WIDTH debe estar sincronizado con el valor de WIA_IPS_XEXTENT, que notifica el ancho, en píxeles, de la página que se va a examinar. El minidriver crea y mantiene esta propiedad.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_PAGES
ScannerDevicePages

Nota:
Windows Vista no admite esta propiedad. Use WIA_IPS_PAGES.

 

Contiene el número actual de páginas que se van a adquirir desde un alimentador automático de documentos. El minidriver crea y mantiene esta propiedad.

Tipo: VT_I4; Acceso: lectura y escritura; Valores válidos: WIA_PROP_RANGE (cero hasta el número máximo de páginas que el alimentador de documentos puede contener)

Una aplicación lee esta propiedad para determinar la capacidad de página del alimentador de documentos. La aplicación también establece esta propiedad en el número de páginas que va a examinar.

Nota:
Si el modo dúplex está habilitado (WIA_DPS_DOCUMENT_HANDLING_SELECT se establece en FEEDER | DUPLEX ), WIA_DPS_PAGES sigue siendo igual al número de páginas que se van a examinar.

 

Una hoja de papel contendrá automáticamente dos páginas si DUPLEX está habilitada, incluso si el lado posterior de la página está en blanco.

Si se establece WIA_DPS_PAGES en 1, un analizador procesará uno de los lados de la página. Se recomienda que si un escáner no puede examinar solo un lado de una página mientras está en modo dúplex, el WIA_DPS_PAGES valor válido para el miembro Inc de la estructura WIA_PROPERTY_INFO debe cambiarse a 2. Este valor indica a la aplicación que debe solicitar páginas en múltiplos de dos. Un valor de cero significa que se van a examinar todas las páginas que se cargan actualmente en el alimentador de documentos.
WIA_DPS_PLATEN_COLOR
ScannerDevicePlatenColor

Especifica el color del plato en la parte posterior de la hoja que se va a examinar. Esta propiedad es opcional para escáneres que tienen una placa. El minidriver crea y mantiene esta propiedad.

Tipo: VT_UI1 VT_VECTOR | , Access: Solo lectura, Valores válidos: WIA_PROP_NONE

El formato de la información de color es RGBQUAD.
WIA_DPS_PREVIEW
ScannerDevicePreview

Nota:
Windows Vista no admite esta propiedad. Use WIA_IPS_PREVIEW.

 

Indica el modo de vista previa de un dispositivo. Una aplicación establece esta propiedad para colocar el dispositivo en un modo de vista previa.

Tipo: VT_I4, Acceso: Lectura y escritura, Valores válidos: WIA_PROP_LIST

En la tabla siguiente se muestran las dos constantes que son válidas con esta propiedad.

Value Definición
WIA_FINAL_SCAN La aplicación realizará un examen final.
WIA_PREVIEW_SCAN La aplicación realizará un examen de vista previa.

 
WIA_DPS_SCAN_AHEAD_PAGES
ScannerDeviceScanAheadPages

Contiene un valor que indica si el analizador almacenará en caché las páginas de un búfer del analizador antes de enviarlos a la aplicación.

Un valor de cero deshabilita el examen por adelantado y no se examinará ninguna página por adelantado. Al realizar transferencias de datos normales en el elemento de exploración anticipada almacenado en búfer, se recuperan las páginas almacenadas en búfer. Las propiedades de WIA no se pueden cambiar durante una operación de exploración anticipada. Esta propiedad es opcional.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_RANGE de cero al número máximo de páginas que puede contener el alimentador de documentos.
WIA_DPS_SCAN_AVAILABLE_ITEM
ScannerDeviceScanAvailableItem

Nota:
Esta propiedad solo es compatible con Windows 7 y versiones posteriores.

 

Indica el origen de entrada (fuente plana, alimentador automático de documentos o adaptador de examen de fil) desde el que se va a examinar o desde la ubicación de almacenamiento desde la que transferir datos.

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.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_RANGE de cero al número máximo de páginas que puede contener el alimentador de documentos.
WIA_DPS_SERVICE_ID
ScannerDeviceServiceId

Nota:
Esta propiedad solo es compatible con Windows Vista y versiones posteriores.

 

Contiene el identificador de servicio de un dispositivo de escáner de servicios web. El mini driver WIA 2.0 crea y mantiene esta propiedad.

Tipo: VT_BSTR, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_SHEET_FEEDER_REGISTRATION
ScannerDeviceSheetFeederRegistration

Nota:
Esta propiedad no es compatible con Windows Vista y versiones posteriores. Use WIA_IPS_SHEET_FEEDER_REGISTRATION.

 

Contiene el registro, o la alineación y la detección de bordes, para los documentos que se colocan en el plano. El minidriver crea y mantiene esta propiedad. Esta propiedad indica cómo se coloca horizontalmente la hoja en el cabezal de escaneo de un escáner portátil o alimentado con hoja. La propiedad se usa para predecir dónde se coloca un documento en el encabezado del examen.

En el caso de los escáneres que admiten más de un cabezal de examen, esta propiedad es relativa al cabezal de examen más alto. Esta propiedad es obligatoria para escáneres de mano, de alimentación de hoja, de desplazamiento y de mano.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE

La tabla siguiente tiene las tres constantes que son válidas con esta propiedad.

Constante Descripción
LEFT_JUSTIFIED La hoja se coloca a la izquierda con respecto a la cabeza del escaneo.
CENTRADO La hoja se centra en la cabeza del escaneo.
RIGHT_JUSTIFIED La hoja se coloca a la derecha con respecto a la cabeza del escaneo.

 
WIA_DPS_SHOW_PREVIEW_CONTROL
ScannerDeviceShowPreviewControl

Nota:
Windows Vista no admite esta propiedad. Use WIA_IPS_SHOW_PREVIEW_CONTROL.

 

Indica si un elemento necesita un control de vista previa que se muestra al usuario. El minidriver crea y mantiene esta propiedad.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE

En la tabla siguiente se muestran las dos constantes que son válidas con esta propiedad.

Constante Descripción
WIA_SHOW_PREVIEW_CONTROL Mostrar un control de vista previa al usuario, ya que este dispositivo puede realizar una vista previa.
WIA_DONT_SHOW_PREVIEW_CONTROL No muestre un control de vista previa al usuario, ya que este dispositivo no puede realizar una vista previa.

 
WIA_DPS_USER_NAME
ScannerDeviceUserName

Nota:
Esta propiedad solo es compatible con Windows Vista y versiones posteriores.

 

Usado por el servicio WIA para informar al mini driver sobre el nombre de la cuenta de usuario (incluido el nombre de dominio de red cuando corresponda) de la sesión en la que se ejecuta la aplicación WIA actual.

Se trata de una propiedad de elemento raíz, administrada por el servicio WIA.

Tipo: VT_BSTR, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_VERTICAL_BED_REGISTRATION
ScannerDeviceVerticalBedRegistration

Nota:
Esta propiedad no es compatible con Windows Vista y versiones posteriores.

 

Contiene el registro, o la alineación vertical y la detección de bordes, para los documentos colocados en el plano. El minidriver crea y mantiene esta propiedad.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE

La tabla siguiente tiene las tres constantes que son válidas con esta propiedad.

Constante Descripción
TOP_JUSTIFIED El papel está justificado por encima.
CENTRADO El papel está centrado.
BOTTOM_JUSTIFIED El papel está justificado en la parte inferior.

 

Consulte también.

WIA_DPS_HORIZONTAL_BED_REGISTRATION
WIA_DPS_VERTICAL_BED_SIZE
ScannerDeviceVerticalBedSize

Nota:
Esta propiedad no es compatible con Windows Vista y versiones posteriores. Use WIA_IPS_MAX_VERTICAL_SIZE.

 

Especifica la altura máxima, en milésimas de pulgada, que se examina en el eje vertical (Y) desde la placa de un escáner plano en la resolución actual. Esta propiedad también se aplica a los alimentadores automáticos de documentos, que mueven hojas a la plancha de un escáner plano para el escaneo. Esta propiedad es obligatoria para escáneres que tienen una plancha. En su lugar, otros tipos de analizador implementarán la propiedad WIA_DPS_VERTICAL_SHEET_FEED_SIZE .

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPS_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceVerticalSheetFeedSize

Nota:
Esta propiedad no es compatible con Windows Vista y versiones posteriores. Use WIA_IPS_MAX_VERTICAL_SIZE.

 

Especifica el alto máximo, en milésimas de pulgada, que se examina en el eje vertical (Y) desde un escáner de alimentación de mano o hoja en la resolución actual. Esta propiedad también se aplica a los alimentadores automáticos de documentos que examinan sin mover hojas a la plancha de un escáner plano. Esta propiedad es obligatoria para escáneres alimentados por hojas. Los escáneres alimentados por desplazamiento y de mano no deben implementar esta propiedad.

Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE

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]
Encabezado
Wiadef.h