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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 ).
[!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. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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.
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.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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: 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. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 ).
Nota: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 ).
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.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 ).
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 ).
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 |
|