Constantes comunes de propiedades de elemento WIA

Las siguientes constantes de propiedad de dispositivo deben ser compatibles con todas las interfaces IWiaItem, IWiaItem2 e IWiaDrvItem Interface , a menos que se indique lo contrario en sus descripciones.

El prefijo "WIA_IPA_" indica una propiedad de elemento para todos los dispositivos y es la convención de nomenclatura usada en C/C++. Con fines de scripting, estas constantes usan el prefijo "Picture" 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_IPA_ACCESS_RIGHTS
PictureAccessRights
Esta marca controla el acceso al elemento, así como si se elimina el elemento.
Obligatorio para todos los elementos wia 2.0.
Tipo: VT_I4; Solo lectura y escritura, en función de la capacidad del elemento de tener sus derechos de acceso cambiados; Valores válidos: WIA_PROP_FLAG
La tabla siguiente tiene las cinco marcas que son válidas con esta propiedad.
Derecho de acceso Descripción
WIA_ITEM_READ El elemento tiene acceso de solo lectura.
WIA_ITEM_WRITE El elemento tiene acceso de solo escritura.
WIA_ITEM_CAN_BE_DELETED El elemento tiene acceso de solo eliminación.
WIA_ITEM_RD WIA_ITEM_READ | WIA_ITEM_CAN_BE_DELETED
WIA_ITEM_RWD WIA_ITEM_READ | WIA_ITEM_WRITE | WIA_ITEM_CAN_BE_DELETED

 

WIA_IPA_APP_COLOR_MAPPING
PictureAppColorMapping

Esta propiedad está reservada para uso futuro y no se implementa en este momento.

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

WIA_IPA_BITS_PER_CHANNEL
PictureBitsPerChannel

Contiene el número de bits por canal de la imagen. El minidriver crea y mantiene esta propiedad.

Necesario para todos los elementos de imagen almacenados o habilitados para la adquisición de WIA 2.0.

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

WIA_IPA_BUFFER_SIZE
PictureBufferSize

Contiene el tamaño del búfer, en bytes, que se usa durante una transferencia de datos. El minidriver crea y mantiene esta propiedad.

Una aplicación puede leer esta propiedad para determinar el tamaño de búfer especificado por el controlador para las transferencias de datos. El servicio WIA también lee esta propiedad para asignar memoria para el minidriver durante la transferencia de datos.

Opcional para todos los elementos wia 2.0 habilitados para transferencia.

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

Nota:
La propiedad WIA_IPA_BUFFER_SIZE contiene es la cantidad mínima de datos que una aplicación puede solicitar en cualquier momento dado. Cuanto mayor sea el tamaño del búfer, mayor será el tamaño de las solicitudes al dispositivo. Esto puede hacer que el dispositivo parezca lento y no responde, puede ralentizar el rendimiento general del sistema y puede consumir recursos excesivos. Los tamaños de búfer demasiado pequeños pueden ralentizar el rendimiento de la transferencia de datos al requerir muchas solicitudes más pequeñas. Elija un tamaño de búfer razonable teniendo en cuenta el tamaño típico de una solicitud de datos al dispositivo y equilibre el número de solicitudes con respecto al tamaño de esas solicitudes.

 
WIA_IPA_BYTES_PER_LINE
PictureBytesPerLine

Contiene el número de bytes en una línea de examen de la imagen. El minidriver crea y mantiene esta propiedad.

Opcional para todos los elementos WIA 2.0.

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

WIA_IPA_CHANNELS_PER_PIXEL
PictureChannelsPerPixel

Contiene el número de canales por píxel de la imagen. El minidriver crea y mantiene esta propiedad.

Necesario para todos los elementos de imagen almacenados o habilitados para la adquisición de WIA 2.0.

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

WIA_IPA_COLOR_PROFILE
PictureColorProfile

Esta propiedad está reservada para uso futuro y no se implementa en este momento.

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

WIA_IPA_COMPRESSION
PictureCompression

Contiene el tipo de compresión actual usado. El minidriver crea y mantiene esta propiedad.

Una aplicación lee esta propiedad para determinar el tipo de compresión de imagen o establece esta propiedad para configurar la configuración de compresión.

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

En la tabla siguiente se muestran las constantes que son válidas con esta propiedad. El símbolo V indica que la constante solo se admite en Windows Vista y versiones posteriores. (Solo está disponible a través de la interfaz IWiaItem2 ).

Tipo de compresión Descripción
WIA_COMPRESSION_NONE Sin compresión. Consulte Nota para obtener más información.
WIA_COMPRESSION_AUTO Modo de compresión automática. Consulte Nota para obtener más información.
WIA_COMPRESSION_BI_RLE4 Compresión RLE4
WIA_COMPRESSION_BI_RLE8 Compresión RLE8
WIA_COMPRESSION_G3 Compresión de grupo 3
WIA_COMPRESSION_G4 Compresión de grupo 4
WIA_COMPRESSION_JPEG Compresión JPEG.
WIA_COMPRESSION_JBIGV Compresión JBIG.
WIA_COMPRESSION_JPEG2KV Compresión JPEG 2000.
WIA_COMPRESSION_PNGV Compresión PNG.

 

[!Nota]

Cuando se WIA_COMPRESSION_NONE esta propiedad y WIA_IPA_FORMAT es WiaImgFmt_PDFA o WiaImgFmt_XPS; a continuación, WIA_COMPRESSION_NONE significa que el modo de compresión no está definido y el analizador debe decidir en un modo.

WIA_COMPRESSION_AUTO es un nuevo valor de propiedad definido para la propiedad WIA_IPA_COMPRESSION. Este valor es válido para todos los elementos de origen de datos de imagen programables, incluidos Flatbed y Feeder. Cuando el mini driver de WIA admite este valor, el cliente de la aplicación WIA puede establecer WIA_IPA_COMPRESSION para habilitar la detección automática del modo de compresión en el dispositivo. WIA_COMPRESSION_AUTO puede funcionar con y sin que se admita o habilite el color automático completo (WIA_DATA_AUTO y WIA_DEPTH_AUTO).

WIA_COMPRESSION_AUTO es más útil con formatos de archivo de transferencia que admiten varios tipos de datos y profundidades de bits, como WiaImgFmt_RAW. Para obtener más información sobre los formatos de archivo de transferencia, vea WIA_IPA_FORMAT en esta tabla.

Es opitonal para que el mini-controlador WIA suporte WIA_COMPRESSION_AUTO. Cuando se admite, el mini-controlador WIA nunca debe establecerlo como valor predeterminado para WIA_IPA_COMPRESSION; solo la aplicación WIA puede establecer este valor.

 
WIA_IPA_DATATYPE
PictureDatatype

Contiene la configuración del tipo de datos actual para el dispositivo. El minidriver crea y mantiene esta propiedad.

Una aplicación lee esta propiedad para determinar el tipo de datos de la imagen. Una aplicación escribe esta propiedad para establecer el tipo de datos actual de la imagen a punto de transferirse.

Esta propiedad es necesaria para todos los elementos wia 2.0. Debe ser de lectura y escritura para todos los elementos habilitados para la adquisición de WIA 2.0 y solo lectura para los elementos de almacenamiento de WIA 2.0.

Tipo: VT_I4; Acceso para sistemas operativos anteriores a Windows Vista: esta propiedad es de solo lectura para cámaras y lectura y escritura para escáneres; Access para Windows Vista y versiones posteriores: esta propiedad es de solo lectura para WIA_CATEGORY_FOLDER y WIA_CATEGORY_FINISHED_FILE elementos, y lectura y escritura para todas las demás categorías de elementos wiA 2.0; Valores válidos: WIA_PROP_LIST

La tabla siguiente tiene las seis constantes que son válidas con cuando WIA_IPA_FORMAT no se establece en WiaImgFmt_RAW.

Tipo de datos Descripción
WIA_DATA_AUTO Válido para todos los elementos de origen de datos de imagen programables, incluido flatbed y feeder. Cuando el mini driver de WIA admite este valor, el cliente de la aplicación WIA puede establecer WIA_IPA_DATATYPE para habilitar la detección automática de colores en el dispositivo. Cuando se establece WIA_DATA_AUTO, el mini-controlador WIA debe actualizar WIA_IPA_DEPTH en el mismo elemento para WIA_DEPTH_AUTO (que debe ser un valor compatible si el dispositivo admite el color automático).
Se trata de un valor opcional, pero es necesario cuando se admite WIA_DEPTH_AUTO para WIA_IPA_DEPTH.
WIA_DATA_COLOR Los datos de examen son de color rojo, verde, azul (RGB). El formato de color completo se describe con las siguientes propiedades de WIA: WIA_IPA_CHANNELS_PER_PIXEL
WIA_IPA_BITS_PER_CHANNEL
WIA_IPA_PLANAR
WIA_IPA_PIXELS_PER_LINE
WIA_IPA_BYTES_PER_LINE
WIA_IPA_NUMBER_OF_LINES
WIA_DATA_COLOR_DITHER Igual que WIA_DATA_COLOR excepto que los datos se anclan mediante el patrón de dither seleccionado actualmente.
WIA_DATA_COLOR_THRESHOLD Igual que WIA_DATA_COLOR excepto que se usa el valor de umbral al examinar los datos. Los valores de color sobre el valor de WIA_IPS_THRESHOLD se convierten en brillo completo; los colores debajo de este valor se convierten en negro.
WIA_DATA_DITHER Los datos de análisis se ditheran mediante el patrón de dither seleccionado actualmente.
WIA_DATA_GRAYSCALE Los datos de examen representan la intensidad. La paleta es una escala de grises fija e igualmente espaciada con una profundidad especificada por WIA_IPA_DEPTH propiedad.
WIA_DATA_THRESHOLD El umbral es de un bit por píxel de datos en blanco y negro. Los datos sobre el valor actual de WIA_IPS_THRESHOLD se convierten en blanco; los datos de este valor se convierten en negro.

 

La propiedad WIA_IPA_DATATYPE también se usa para describir el tipo de transferencia de datos RAW que se usará cuando la aplicación establece WiaImgFmt_RAW. El controlador debe establecer la propiedad WIA_IPA_DATATYPE en una lista de valores permitidos desde los que la aplicación puede elegir uno.

Si el dispositivo solo se puede establecer en un valor único, cree un tipo de WIA_PROP_LIST y coloque el valor válido en él.

Compruebe la propiedad WIA_IPA_DEPTH para determinar la profundidad del bit. Esta propiedad normalmente contiene un único valor para las cámaras.

En la tabla siguiente se enumeran las constantes que son válidas con WIA_IPA_DATATYPE cuando WIA_IPA_FORMAT se establece en WiaImgFmt_RAW.

Tipo de datos Descripción
WIA_DATA_GRAYSCALE Los datos de examen representan la intensidad. La paleta es una escala de grises fija, igual de espaciada, con una profundidad especificada por la propiedad WIA_IPA_DEPTH . WIA_IPA_RAW_BITS_PER_CHANNEL debe establecerse en 1.
WIA_DATA_RAW_BGR Los datos de examen están en el espacio de colores BGR (azul-verde-rojo). El formato de color completo se describe con las siguientes propiedadesWIA: WIA_IPA_CHANNELS_PER_PIXEL
WIA_IPA_BITS_PER_CHANNEL
WIA_IPA_PIXELS_PER_LINE
WIA_IPA_BYTES_PER_LINE
WIA_IPA_NUMBER_OF_LINES
WIA_IPA_RAW_BITS_PER_CHANNEL debe establecerse en 3.
WIA_DATA_RAW_CMY Los datos de análisis están en el espacio de colores cian-magenta-amarillo (CMY). El formato de color completo se describe con las mismas propiedades de WIA que en WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL debe establecerse en 3.
WIA_DATA_RAW_CMYK Los datos de análisis están en el espacio de colores cian-magenta-amarillo-negro (CMYK). El formato de color completo se describe con las mismas propiedades de WIA que en WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL debe establecerse en 4.
WIA_DATA_RAW_RGB Los datos de examen están en el espacio de colores rojo-verde-azul (RGB). El formato de color completo se describe con las mismas propiedades de WIA que en WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL debe establecerse en 3.
WIA_DATA_RAW_YUV Los datos de examen se encuentra en el espacio de colores de diferencia y rojo de la diferencia de la luminancia azul (YUV). El formato de color completo se describe con las mismas propiedades de WIA que en WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL debe establecerse en 3.
WIA_DATA_RAW_YUVK Los datos de examen están en el espacio de colores de diferencia de color rojo de la luminancia-azul -negro (YUVK). El formato de color completo se describe con las mismas propiedades de WIA que en WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL debe establecerse en 4.

 

WIA_IPA_DEPTH
PictureDepth

WIA_IPA_DEPTH Contiene la configuración de profundidad de bits de una imagen. El minidriver crea y mantiene esta propiedad. Una aplicación lee esta propiedad para determinar la configuración de profundidad de bits de la imagen. Es posible que la aplicación también pueda establecer este valor en la profundidad de bits deseada.

Si el dispositivo solo se puede establecer en un valor único, cree un tipo de WIA_PROP_LIST y coloque el valor válido en él.

Esta propiedad es necesaria para todos los elementos wia 2.0. Debe ser de lectura y escritura para todos los elementos habilitados para la adquisición de WIA 2.0 y solo lectura para los elementos de almacenamiento de WIA 2.0.

Tipo: VT_I4; Acceso para sistemas operativos anteriores a Windows Vista: lectura y escritura; Access para Windows Vista y versiones posteriores: esta propiedad es de solo lectura para WIA_CATEGORY_FOLDER y WIA_CATEGORY_FINISHED_FILE elementos, y lectura y escritura para todas las demás categorías de elementos wiA 2.0; Valores válidos: WIA_PROP_LIST

WIA_DEPTH_AUTO se define como 0 bits por píxel y es un nuevo valor de propiedad definido para el WIA_IPA_DEPTH. Este valor es válido para todos los elementos de origen de datos de imagen programables, incluidos Flatbed y Feeder. Cuando el mini driver wia admite WIA_DEPTH_AUTO, el cliente de la aplicación WIA puede establecer WIA_IPA_DEPTH en este valor para habilitar la detección automática de colores en el dispositivo. Cuando se establece WIA_DEPTH_AUTO, el minicontrolador WIA debe actualizar WIA_IPA_DATATYPE en el mismo elemento a WIA_DATA_AUTO (que debe ser un valor admitido, si el dispositivo admite el color automático).

WIA_DEPTH_AUTO es un valor opcional, pero se requiere cuando se admite WIA_DATA_AUTO para WIA_IPA_DATATYPE.

WIA_IPA_FILENAME_EXTENSION
PictureFilenameExtension

Contiene la extensión de nombre de archivo para un formato de archivo determinado. El minidriver crea y mantiene esta propiedad.

Opcional para todos los elementos WIA 2.0 habilitados para transferencia.

Tipo: VT_BSTR, Acceso: Solo lectura, Valores válidos: WIA_PROP_NONE

El controlador actualiza esta propiedad para reflejar el valor actual de la propiedad WIA_IPA_FORMAT .

Por ejemplo, si WIA_IPA_FORMAT es WiaImgFmt_JPEG , WIA_IPA_FILENAME_EXTENSION debe ser jpg. Si WIA_IPA_FORMAT está WiaImgFmt_BMP , WIA_IPA_FILENAME_EXTENSION debe ser BMP.

Nota:
La extensión de nombre de archivo no incluye el punto.

 

Esta propiedad se recomienda para los controladores que admiten formatos estándar y son necesarios para los controladores que implementan formatos definidos por el personalizado. Informa a la aplicación de la extensión de nombre de archivo correcta que se va a usar durante la transferencia de archivos con formato privado. Por ejemplo, si A. Datum Corporation creó un controlador WIA que transfirió un archivo en un nuevo formato, la empresa podría especificar una extensión de "adc". Esto permite a las aplicaciones transferir datos en ese formato a un archivo y crear un nombre de archivo como myfile.adc, que resulta útil para otros usuarios que entienden la nueva extensión.

WIA_IPA_FORMAT
Pictureformat

Contiene el formato actual de la imagen a punto de transferirse.

Una aplicación lee esta propiedad para determinar el formato de la imagen que está a punto de recibir. Una aplicación escribe esta propiedad para establecer el formato. Esta propiedad depende de la propiedad WIA_IPA_TYMED . El minidriver crea y mantiene esta propiedad.

Si el dispositivo solo se puede establecer en un valor único, cree un tipo de WIA_PROP_LIST y coloque el valor válido en él.

Tipo: CLSID, Access: Lectura y escritura, Valores válidos: WIA_PROP_LIST

En la tabla siguiente se enumeran las constantes que son válidas con esta propiedad. El asterisco * indica que la constante no se admite en Windows Vista. (Solo está disponible a través de la interfaz IWiaItem ). El asterisco doble ** indica que la constante no se admite en Windows Server 2003 o Windows Vista. El símbolo V indica que la constante solo se admite en Windows Vista y versiones posteriores. (Solo está disponible a través de la interfaz IWiaItem2 ).

Formato Descripción
WiaAudFmt_AIFF Formato de audio AIFF
WiaAudFmt_MP3 Formato de audio MP3
WiaAudFmt_WAV Formato de audio WAV
WiaAudFmt_WMA Formato de audio WMA
WiaImgFmt_ASF** Formato de vídeo ASF
WiaImgFmt_AVI** Formato de vídeo AVI
WiaImgFmt_BMP Mapa de bits de Windows con un archivo de encabezado
WiaImgFmt_CIFF* Formato de archivo de imagen de cámara
WiaImgFmt_DPOF Formato de impresión DPOF
WiaImgFmt_EMF Metarchivo extendido de Windows
WiaImgFmt_EXEC Archivo ejecutable
WiaImgFmt_EXIF Formato de archivo intercambiable
WiaImgFmt_FLASHPIX Formato FlashPix
WiaImgFmt_GIF Formato de imagen GIF
WiaImgFmt_HTML Formato HTML
WiaImgFmt_ICO Formato de archivo de icono de Windows
WiaImgFmt_JBIGV Formato conjunto de expertos en imágenes de nivel binimal (JBIG).
WiaImgFmt_JPEG Formato comprimido JPEG
WiaImgFmt_JPEG2K Formato comprimido JPEG 2000
WiaImgFmt_JPEG2KX Formato comprimido JPEG 2000
WiaImgFmt_MEMORYBMP Mapa de bits de Windows sin un archivo de encabezado
WiaImgFmt_PDFAV Formato PDF/A (ISO/CD 19005-1).
WiaImgFmt_MPG** Formato de vídeo MPEG
WiaImgFmt_PHOTOCD Formato de archivo Eastman Kodak
WiaImgFmt_PICT Formato de archivo de Apple
WiaImgFmt_PNG Formato PNG de W3C
WiaImgFmt_RAW Formato sin formato solo para transferencias de datos
WiaImgFmt_RAWRGB Formato RGB sin formato
WiaImgFmt_RTF Formato de archivo de texto enriquecido
WiaImgFmt_SCRIPT Archivo de script
WiaImgFmt_TIFF Formato TIFF
WiaImgFmt_TXT Archivo de texto
WiaImgFmt_UNICODE16 Codificación unicode de 16 bits
WiaImgFmt_WMF Metarchivo de Windows
WiaImgFmt_XML Archivo XML
WiaImgFmt_XPSV Formato de paquete XPS

 

Nota:
Cuando esta propiedad es WiaImgFmt_PDFA o WiaImgFmt_XPS, y WIA_IPA_COMPRESSION se WIA_COMPRESSION_NONE; después, el último valor significa que el modo de compresión no está definido y el analizador debe decidir en un modo.

 
WIA_IPA_FULL_ITEM_NAME
PictureFullItemName

Contiene el nombre completo del elemento (el nombre del elemento junto con la información de ruta de acceso). El nombre completo del elemento es el mismo que el parámetro bstrFullItemName de la función de utilidad de servicio wiasCreateDrvItem . Una aplicación lee esta propiedad para determinar qué elemento está usando actualmente y dónde se encuentra ese elemento en el árbol de elementos. Cada elemento debe tener un nombre único. Las aplicaciones suelen usar el nombre completo del elemento para buscar elementos en el árbol de elementos. El servicio WIA crea y mantiene esta propiedad.

Obligatorio para todos los elementos wia 2.0.

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

WIA_IPA_GAMMA_CURVES
PictureGammaCurves

Esta propiedad está reservada para uso futuro y no se implementa en este momento.

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

WIA_IPA_ICM_PROFILE_NAME
PictureIcmProfileName

Contiene el nombre del perfil de ICM necesario para descodificar correctamente la imagen. Una aplicación lee esta propiedad para determinar el perfil de ICM que se usará al procesar la imagen. El servicio WIA crea y mantiene esta propiedad en función de la entrada ICMProfiles en el archivo de instalación del controlador.

Tipo: VT_BSTR, Acceso: Solo lectura, Valores válidos: WIA_PROP_NONE

WIA_IPA_ITEM_CATEGORY
PictureItemCategory

Solo se admite en Windows Vista y versiones posteriores.

Los elementos de WIA 2.0 se agrupan en categorías que definen cómo se va a tratar o usar un IWiaItem2 . Por ejemplo, si el elemento representa un alimentador, la aplicación debe esperar que contenga las propiedades necesarias del alimentador de documentos y funcione como un alimentador de documentos. Si el elemento representa un archivo terminado, una aplicación WIA 2.0 debe tratarlo de este modo, suponiendo que los datos son estáticos y se encuentran en el dispositivo. (Las reglas de cada elemento se definirán en sus documentos de especificación individuales).

Obligatorio para todos los elementos wia 2.0.

Tipo: VT_CLSID, Acceso: Solo lectura, Valores válidos: GUID de categoría de elemento

WIA_IPA_ITEM_FLAGS
PictureItemFlags

Contiene las marcas descriptivas de un elemento WIA. Las marcas de elemento son las mismas que las del parámetro lObjectFlags de la función de utilidad de servicio wiasCreateDrvItem . El servicio WIA crea y mantiene esta propiedad.

Una aplicación lee esta propiedad para determinar los valores de marca descriptivos del elemento.

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

En la tabla siguiente se muestran las marcas que son válidas con esta propiedad. Un asterisco * indica que la marca no se admite en Windows Vista o posterior. (Solo está disponible a través de la interfaz IWiaItem ). Un asterisco doble ** indica que la marca no se admite en Windows Server 2003 o Windows Vista o versiones posteriores. El símbolo V indica que la marca solo se admite en Windows Vista y versiones posteriores. (Solo está disponible a través de la interfaz IWiaItem2 ).

Marca Definición
WiaItemTypeAnalyze* Este elemento admite el método IWiaItem::AnalyzeItem (descrito en la documentación del SDK de plataforma). Este elemento también admite la generación automática de elementos secundarios. Esta funcionalidad es útil para la detección de regiones o la descomposición de página.
WiaItemTypeAudio Este elemento admite audio. Esta marca solo es válida para los elementos que también tienen establecida la marca WiaItemTypeFile .
WiaItemTypeBurst* Solo para carpetas. Esta marca indica que las imágenes de esta carpeta se tomaron en una secuencia de tiempo continua.
WiaItemTypeDeleted Este elemento está marcado para su eliminación, este elemento se ha eliminado, este elemento no existe o el contenido de este elemento no es válido.
WiaItemTypeDocumentV Este elemento es un archivo de documento en uno de los formatos de documento que contiene la propiedad WIA_IPA_FORMAT . (Estos formatos incluyen los de archivos que no son de imagen inicial, como archivos .txt, .htm y .doc).
WiaItemTypeDevice Este elemento representa un dispositivo conectado.
WiaItemTypeDisconnected Este elemento representa un dispositivo desconectado.
WiaItemTypeFile El elemento admite transferencias de archivos.
WiaItemTypeFolder El elemento es una carpeta.
WiaItemTypeFree El elemento no está inicializado o se ha eliminado.
WiaItemTypeGenerated Este elemento lo ha generado una aplicación o el controlador.
WiaItemTypeHasAttachments* Este elemento admite datos adjuntos y actualmente contiene datos adjuntos.
WiaItemTypeHPanorama* Este elemento representa una imagen panorámica horizontal. Esta marca solo es válida para los elementos que también tienen establecida la marca WiaItemTypeFolder .
WiaItemTypeImage El elemento es un archivo de imagen. Esta marca solo es válida para los elementos que también tienen establecida la marca WiaItemTypeFile .
WiaItemTypeProgrammableDataSourceV El elemento es un origen de datos programable y sigue un conjunto de reglas de configuración predefinidas, que se basan en WIA_IPA_ITEM_CATEGORY.
WiaItemTypeRootV Este elemento es el elemento raíz, que es el elemento primario de todos los elementos de características que admite el dispositivo.
WiaItemTypeStorage Esta marca indica almacenamiento adicional para los elementos de carpetas. Los controladores WIA especifican sus elementos en términos de imágenes y carpetas. No existen propiedades WIA que describan las características de un elemento de almacenamiento (como el espacio de almacenamiento restante, la velocidad de escritura o el tipo de medio. Se pueden agregar propiedades específicas del proveedor que exponen esta información. Estas propiedades solo son accesibles para las aplicaciones o extensiones que se escriben para reconocerlas.
WiaItemTypeTransfer Este elemento se puede usar para transferir datos.
WiaItemTypeTwainCapabilityPassThrough Este tipo indica que el dispositivo WIA puede recibir datos de funcionalidad de TWAIN del nivel de compatibilidad de TWAIN. Si se establece este tipo, cualquier funcionalidad de TWAIN que no comprenda la capa de compatibilidad de TWAIN se pasará al controladorWIA. Esto solo es válido para el elemento raíz.
WiaItemTypeVideo** Este elemento admite el streaming de vídeo.
WiaItemTypeVPanorama* Este elemento representa una imagen panorámica vertical. Esta marca solo es válida para los elementos que también tienen establecida la marca WiaItemTypeFolder .

 

Algunas de estas marcas son necesarias o opcionales para los elementos WIA 2.0, según la categoría del elemento, como se muestra en esta tabla.

Categoría de elemento Obligatorio Opcionales
WIA_CATEGORY_ROOT WiaItemTypeRoot WiaItemTypeFolder WiaItemTypeDevice WiaItemTypeDisconnected
WIA_CATEGORY_FLATBED WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder (si se admiten varios elementos de regiones de examen, esta marca solo es opcional para el elemento raíz de WIA_CATEGORY_FLATBED).
WIA_CATEGORY_FEEDER WIA_CATEGORY_FEEDER_FRONT WIA_CATEGORY_FEEDER_BACK WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder (si WIA_CATEGORY_FEEDER_FRONT y WIA_CATEGORY_FEEDER_BACK elementos están presentes, esta marca solo es opcional para el elemento raíz de WIA_CATEGORY_FEEDER).
WIA_CATEGORY_FILM (raíz) WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder None
WIA_CATEGORY_FILM (elementos secundarios) WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile None
WIA_CATEGORY_FOLDER WiaItemTypeStorage WiaItemTypeFolder WiaItemTypeDeleted
WIA_CATEGORY_FINISHED_FILE WiaItemTypeFile WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeAudio WiaItemTypeDeleted

 

WIA_IPA_ITEM_NAME
PictureItemName

Contiene el nombre del elemento. Una aplicación lee esta propiedad para determinar qué elemento está usando actualmente. Cada elemento tiene un nombre único. El servicio WIA crea y mantiene esta propiedad.

Obligatorio para todos los elementos wia 2.0.

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

WIA_IPA_ITEM_SIZE
PictureItemSize

Contiene el tamaño actual, en bytes, de los datos asociados al elemento. El minidriver crea y mantiene esta propiedad.

Contains es el tamaño total de los datos que se transfieren. Si este valor es cero, significa que el minidriver no tiene información sobre el tamaño exacto de los datos. (Esto es común para los datos comprimidos). Una aplicación lee este valor para determinar el tamaño de la adquisición antes de que tenga lugar. El servicio WIA lee esta propiedad para ayudar a asignar memoria para transferencias de datos. Para obtener más información, consulte Transferencia de datos a una aplicación WIA si la propiedad está establecida en cero y TYMED está configurada para una transferencia de archivos, el servicio WIA no asigna ninguna memoria para el minidriver WIA.

Obligatorio para todos los elementos wia 2.0 habilitados para transferencia.

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

WIA_IPA_ITEM_TIME
PictureItemTime

Contiene la hora en que se capturó originalmente la imagen. El minidriver crea y mantiene esta propiedad. Esta propiedad debe notificarse como un vector de ocho valores de WORD en forma de una estructura SYSTEMTIME (descrita en la documentación del SDK de plataforma).

Opcional para todos los elementos WIA 2.0.

Tipo: VT_UI2acceso VT_VECTOR | : lectura y escritura o solo lectura, valores válidos: WIA_PROP_NONE

WIA_IPA_ITEMS_STORED
PictureItemItemsStored

Solo se admite en Windows Vista y versiones posteriores.

Especifica cuántos elementos se almacenan en el elemento WIA_CATEGORY_FOLDER.

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

WIA_IPA_MIN_BUFFER_SIZE
PictureMinBufferSize

Especifica el tamaño mínimo del búfer que se usa en las transferencias de datos. Si la transferencia de datos se realiza a través de un mecanismo de devolución de llamada, el valor de la propiedad puede ser tan pequeño como 64 KB. Sin embargo, si la transferencia es al archivo, el valor de la propiedad es el número de bytes necesarios para transferir una página de datos a la vez. El minidriver crea y mantiene esta propiedad WIA.

Opcional para todos los elementos wia 2.0 habilitados para transferencia.

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

WIA_IPA_NUMBER_OF_LINES
PictureNumberOfLines

Contiene el número de líneas contenidas en la imagen (el alto vertical de la imagen en píxeles). El minidriver crea y mantiene esta propiedad.

Opcional para todos los elementos WIA 2.0.

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

WIA_IPA_PIXELS_PER_LINE
PicturePixelsPerLine

Contiene el número de píxeles de cada línea de la imagen (el ancho de la imagen en píxeles). El minidriver crea y mantiene esta propiedad.

Opcional para todos los elementos WIA 2.0.

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

WIA_IPA_PLANAR
PicturePlanar

Esta propiedad no se admite en Windows Vista y versiones posteriores.

Contiene opciones de empaquetado de datos de imagen. El minidriver crea y mantiene esta propiedad.

Una aplicación lee esta propiedad para determinar las opciones de empaquetado de imágenes o establece las opciones de empaquetado de imágenes actuales.

Tipo: VT_I4; Acceso: lectura y escritura; Valores válidos: WIA_PROP_LIST. Si el dispositivo solo se puede establecer en un valor único, cree un tipo de WIA_PROP_LIST y coloque el valor válido en él.

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

Value Definición
WIA_PACKED_PIXEL Los datos de imagen están en formato de píxel empaquetado.
WIA_PLANAR Los datos de imagen están en formato planar.

 

WIA_IPA_PREFERRED_FORMAT
PicturePreferredFormat

Contiene el formato preferido para las imágenes que transfiere este minidriver. El minidriver crea y mantiene esta propiedad.

Obligatorio para todos los elementos WIA 2.0 habilitados para transferencia.

Tipo: CLSID, Access: Solo lectura, valores válidos: WIA_PROP_NONE

WIA_IPA_PROP_STREAM_COMPAT_ID
PicturePropStreamCompatId

Especifica un CLSID que representa un conjunto de valores de propiedad de dispositivo. Si un controlador de dispositivo implementa esta característica, las aplicaciones usan esta propiedad para determinar si el dispositivo admite un conjunto de valores.

Tipo: CLSID, Access: Solo lectura, valores válidos: WIA_PROP_LIST

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

Value Definición
WiaImgFmt_BMP Mapa de bits de MicrosoftWindows con un archivo de encabezado
WiaImgFmt_EMF Metarchivo extendido de Windows
WiaImgFmt_EXIF Formato de archivo intercambiable
WiaImgFmt_FLASHPIX Formato FlashPix
WiaImgFmt_GIF Formato de imagen GIF
WiaImgFmt_ICO Formato de archivo de icono de Windows
WiaImgFmt_JPEG Formato comprimido JPEG
WiaImgFmt_PHOTOCD Formato de archivo Eastman Kodak
WiaImgFmt_PNG Formato PNG de W3C
WiaImgFmt_MEMORYBMP Mapa de bits de Windows sin un archivo de encabezado
WiaImgFmt_TIFF Formato TIFF
WiaImgFmt_WMF Metarchivo de Windows

 

WIA_IPA_RAW_BITS_PER_CHANNEL
PictureRawBitsPerChannel

Solo se admite en Windows Vista y versiones posteriores.

Contiene el número de bits de cada canal. Esta propiedad se debe notificar como un vector de tantos valores BYTE como hay canales, donde el primer BYTE corresponde al número de bits del primer canal, el segundo byte al número de bits del segundo canal, etc. Debe haber tantas entradas como canales según WIA_IPA_CHANNELS_PER_PIXEL. El controlador establece esa propiedad cuando la aplicación cambia a WiaImgFmt_RAW. Para los subtipos conocidos, hay tantas entradas como se enumeran en la tabla en WIA_IPA_RAW_SUBTYPE.

Tipo: VT_UI1 VT_VECTOR|, Access: Read Only, Valid values: WIA_PROP_NONE

WIA_IPA_REGION_TYPE
PictureRegionType

Esta propiedad está reservada para uso futuro y no se implementa en este momento.

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

WIA_IPA_SUPPRESS_PROPERTY_PAGE
PictureSuppressPropertyPage

Especifica si se deben suprimir las páginas de propiedades generales de los elementos del dispositivo.

Esta propiedad está disponible en Windows XP y versiones posteriores.

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

En la tabla siguiente se muestran las constantes que son válidas con esta propiedad. El asterisco * indica que la constante no es válida con Windows Vista y versiones posteriores. (Solo está disponible a través de la interfaz IWiaItem ).

Constante Descripción
WIA_PROPPAGE_CAMERA_ITEM_GENERAL* Suprima la página de propiedades de elemento general de una cámara.
WIA_PROPPAGE_SCANNER_ITEM_GENERAL Suprima la página de propiedades de elemento general de un escáner.

 

WIA_IPA_TYMED
PictureTymed

Esta propiedad contiene la configuración del método de transferencia. El minidriver crea y mantiene esta propiedad.

Una aplicación lee esta propiedad para determinar el método de transferencia de datos del minidriver.

Obligatorio para todos los elementos WIA 2.0 habilitados para transferencia.

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

En la tabla siguiente se muestran las constantes que son válidas con esta propiedad. El asterisco * indica constantes que no son válidas con Windows Vista y versiones posteriores. (Solo están disponibles a través de la interfaz IWiaItem ).

Tipo de transferencia Descripción
TYMED_CALLBACK* Transferir una imagen a la memoria, en bandas.
TYMED_MULTIPAGE_CALLBACK* Transferir varias imágenes a la memoria, en bandas.
TYMED_FILE Transferir una imagen a un archivo.
TYMED_MULTIPAGE_FILE Transferir una imagen a un archivo.

 

WIA_IPA_UPLOAD_ITEM_SIZE
PictureItemUploadItemSize

Solo se admite en Windows Vista y versiones posteriores.

Especifica el número de bytes que se van a cargar para un elemento.

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

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