Compartir a través de

Constantes de propiedad del dispositivo de cámara

  • 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 las cámaras digitales. El prefijo "WIA_DPC_" indica una propiedad device para cámaras y es la convención de nomenclatura que se usa en C/C++. Con fines de scripting, estas constantes usan el prefijo "CameraDevice" 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.

Nota

WIA no admite cámaras en Windows Vista ni versiones posteriores. Para esas versiones de Windows, use la API de dispositivo portátil (WPD) de Windows que se describe en el Kit de desarrollo de controladores de Windows (DDK) para adquirir imágenes de cámaras.

 

Constante o valor Descripción
WIA_DPC_PICTURES_TAKEN
CameraDevicePicturesTaken
 Número de imágenes que ha tomado la cámara. El minidriver crea y mantiene esta propiedad.
Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPC_PICTURES_REMAINING
CameraDevicePicturesRemaining
 Número de imágenes que se pueden tomar, dada la configuración de la propiedad actual. Si cambian estas configuraciones y los cambios afectan al tamaño de las imágenes que genera el dispositivo de cámara, el minidriver WIA debe actualizar el número de imágenes restantes. El minidriver crea y mantiene esta propiedad.
Tipo: VT_I4, Access: Solo lectura, Valores válidos: WIA_PROP_NONE
WIA_DPC_EXPOSURE_MODE
CameraDeviceExposureMode
 Indica el modo de exposición actual de la cámara. Una aplicación cambia esta propiedad para controlar el modo de exposición del dispositivo de cámara.
Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_LIST
La tabla siguiente tiene las siete constantes que son válidas con esta propiedad.
Modo de exposición Descripción
EXPOSUREMODE_MANUAL El usuario establece la velocidad y la apertura del obturador.
EXPOSUREMODE_AUTO La cámara establece automáticamente la velocidad y la apertura del obturador.
EXPOSUREMODE_APERTURE_PRIORITY El usuario establece la apertura y la cámara establece automáticamente la velocidad de obturación.
EXPOSUREMODE_SHUTTER_PRIORITY El usuario establece la velocidad del obturador y la cámara establece automáticamente la apertura.
EXPOSUREMODE_PROGRAM_CREATIVE La velocidad y la apertura del obturador se establecen automáticamente por la cámara, optimizadas para la materia.
EXPOSUREMODE_PROGRAM_ACTION La cámara establece automáticamente la velocidad y la apertura del obturador, optimizadas para escenas que contienen movimiento rápido.
EXPOSUREMODE_PORTRAIT La velocidad y la apertura del obturador se establecen automáticamente por la cámara, optimizadas para la fotografía vertical.

 
WIA_DPC_EXPOSURE_COMP
CameraDeviceExposureComp

Permite el ajuste del punto de conjunto del control de exposición automática de la cámara digital. Por ejemplo, un valor de cero no cambia el nivel de exposición automática del conjunto de fábrica. Las unidades están en "paradas" que se escalan por un factor de 1000, para permitir valores de detención fraccionarios. Un valor de 2000 corresponde a dos paradas más de exposición (cuatro veces más energía en el sensor), lo que produce imágenes más brillantes. Un valor de -1000 corresponde a una detención de menos exposición (una mitad de la energía en el sensor) que produce imágenes más oscuras. Los valores de configuración se encuentran en unidades del Sistema aditivo de exposición fotográfica (APEX). Esta propiedad se puede expresar como una lista o un intervalo de valores. Esta propiedad se usa normalmente solo cuando el dispositivo tiene la propiedad WIA_DPC_EXPOSURE_MODE establecida en EXPOSUREMODE_MANUAL.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_RANGE o WIA_PROP_LIST
WIA_DPC_EXPOSURE_TIME
CameraDeviceExposureTime

Corresponde a la velocidad de obturación, en segundos que se escalan en 10 000. Normalmente, el dispositivo usa esta propiedad solo cuando la propiedad WIA_DPC_EXPOSURE_MODE está establecida en EXPOSUREMODE_MANUAL o EXPOSUREMODE_SHUTTER_PRIORITY.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_RANGE o WIA_PROP_LIST
WIA_DPC_FNUMBER
CameraDeviceFNumber

Corresponde a la apertura de la lente, en unidades del número de parada f escalado en 100. El valor de esta propiedad suele ser válido solo cuando la propiedad WIA_DPC_EXPOSURE_MODE está establecida en EXPOSUREMODE_MANUAL o EXPOSUREMODE_APERTURE_PRIORITY.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_LIST
WIA_DPC_FLASH_MODE
CameraDeviceFlashMode

Define la configuración del modo flash actual para el dispositivo de cámara. El controlador de dispositivo enumera los valores admitidos de esta propiedad. Una aplicación escribe esta propiedad para establecer el modo flash del dispositivo de cámara.

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

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

Modo flash Definición
FLASHMODE_AUTO El dispositivo de cámara determina la configuración de flash adecuada.
FLASHMODE_FILL El dispositivo de cámara está configurado para parpadear independientemente de las condiciones de iluminación actuales.
FLASHMODE_OFF El dispositivo de cámara está configurado para no parpadear para ninguna imagen tomada.
FLASHMODE_REDEYE_AUTO El dispositivo de cámara determina la configuración de flash adecuada mediante la reducción de ojos rojos, independientemente de las condiciones de iluminación actuales.
FLASHMODE_REDEYE_FILL El dispositivo de cámara está configurado para usar la reducción de ojos rojos y flash independientemente de las condiciones de iluminación actuales.
FLASHMODE_EXTERNALSYNC El dispositivo de cámara está configurado para sincronizarse con unidades flash externas.

 
WIA_DPC_FOCUS_MODE
CameraDeviceFocusMode

Define la configuración del modo de enfoque actual para el dispositivo de cámara. El controlador de dispositivo enumera los valores admitidos de esta propiedad. Una aplicación escribe esta propiedad para establecer el modo de enfoque para el dispositivo de cámara.

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

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

Modo de enfoque Descripción
FOCUSMODE_MANUAL El dispositivo de cámara está configurado para permitir que el usuario se centre manualmente.
FOCUSMODE_AUTO El dispositivo de cámara está configurado para centrarse automáticamente.
FOCUSMODE_MACROAUTO El dispositivo de cámara está configurado para centrarse automáticamente mediante la configuración de macros de corto alcance.

 
WIA_DPC_FOCUS_MANUAL_DIST

Reservado, no use.

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

Reservado, no use.

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

Reservado, no use.

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

Reservado, no use.

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

Reservado, no use.

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

Reservado, no use.

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

Define la fuente de alimentación actual para el dispositivo de cámara. Una aplicación lee esta propiedad para determinar qué fuente de alimentación usa la cámara.

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

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

Modo de energía Descripción
POWERMODE_LINE El dispositivo de cámara funciona en un adaptador de alimentación.
POWERMODE_BATTERY El dispositivo de cámara funciona con batería.

 
WIA_DPC_BATTERY_STATUS
CameraDeviceBatteryStatus

Porcentaje de energía de la batería que queda para operar el dispositivo de cámara. Este valor debe ser un entero comprendido entre 0 y 100. Una aplicación lee esta propiedad para determinar la duración restante de la batería del dispositivo de cámara.

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

Ancho, en píxeles, de una imagen en miniatura que se va a usar para las imágenes recién capturadas. Una aplicación lee este valor para obtener un tamaño estimado para mostrar miniaturas en su interfaz de usuario.

Tipo: VT_I4, Acceso: lectura y escritura (WIA_PROP_LIST) o Solo lectura (WIA_PROP_NONE), Valores válidos: WIA_PROP_LIST o WIA_PROP_NONE
WIA_DPC_THUMB_HEIGHT
CameraDeviceThumbHeight

Ancho, en píxeles, de una imagen en miniatura que se va a usar para las imágenes recién capturadas. Una aplicación lee este valor para obtener un tamaño estimado para mostrar miniaturas en su interfaz de usuario.

Tipo: VT_I4, Acceso: lectura y escritura (WIA_PROP_LIST) o Solo lectura (WIA_PROP_NONE), Valores válidos: WIA_PROP_LIST o WIA_PROP_NONE
WIA_DPC_PICT_WIDTH
CameraDevicePictWidth

Ancho en píxeles que se va a usar para las imágenes capturadas recientemente. La lista de valores válidos para esta propiedad tiene una correspondencia uno a uno con la lista de valores válidos para la propiedad WIA_DPC_PICT_HEIGHT . Si el ancho y la altura individuales son linealmente configurables y ortogonales entre sí, se pueden expresar como un intervalo.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_PICT_HEIGHT
CameraDevicePictHeight

Alto en píxeles que se va a usar para las imágenes recién capturadas. La lista de valores válidos para esta propiedad tiene una correspondencia uno a uno con la lista de valores válidos para la propiedad WIA_DPC_PICT_WIDTH . Si el ancho y la altura individuales son linealmente configurables y ortogonales entre sí, se pueden expresar como un intervalo.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_DIMENSION

Reservado, no use.

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

Diseñado para ser aproximadamente lineal con respecto a la calidad de la imagen percibida en una amplia gama de contenido de escena, y contiene un rango o una lista de enteros. Los enteros más pequeños se usan para representar una menor calidad (es decir, compresión máxima), mientras que los enteros más grandes se usan para representar una mayor calidad (es decir, compresión mínima). Cualquier configuración disponible en un dispositivo solo es relativa a ese dispositivo y, por tanto, es específica del dispositivo.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_FOCUS_METERING

Reservado, no use.

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

El tiempo, en milisegundos, entre las capturas de imagen en una operación de captura de período de tiempo.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_NONE, WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_TIMELAPSE_NUMBER
CameraDeviceTimelapseNumber

Número de imágenes que el dispositivo intenta capturar durante una captura de tiempo de expiración.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_NONE, WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_BURST_INTERVAL
CameraDeviceBurstInterval

El tiempo, en milisegundos, entre capturas de imagen durante una operación de ráfaga.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_NONE, WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_BURST_NUMBER
CameraDeviceBurstNumber

Número de imágenes que el dispositivo intenta capturar durante una operación de ráfaga.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_NONE, WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_EFFECT_MODE
CameraDeviceEffectMode

Especifica el modo especial de adquisición de imágenes de la cámara.

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

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

Modo efecto Descripción
EFFECTMODE_STANDARD Capture una imagen en el modo estándar para la cámara.
EFFECTMODE_BW Capture una imagen de escala de grises.
EFFECTMODE_SEPIA Capture una imagen sepia.

 
WIA_DPC_DIGITAL_ZOOM
CameraDeviceDigitalZoom

La relación de zoom efectiva de la imagen adquirida de la cámara digital, escalada por un factor de 10. Un valor de 10 corresponde a la ausencia de zoom digital (1X), que es el tamaño de escena estándar capturado por la cámara. Un valor de 20 corresponde a un zoom 2X, donde la cámara captura un cuarto del tamaño de la escena estándar.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_SHARPNESS
CameraDeviceSharpness

La nitidez percibido de una imagen capturada. Esta propiedad puede usar una lista de valores o un intervalo de valores. El valor mínimo representa la menor cantidad de nitidez, mientras que el valor máximo representa la nitidez máxima. Normalmente, un valor en medio del intervalo representa la nitidez normal o predeterminada.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_CONTRAST
CameraDeviceContrast

Contraste percibido de una imagen capturada. Esta propiedad puede contener una lista de valores o un intervalo de valores. El valor mínimo admitido representa la menor cantidad de contraste, mientras que el valor máximo representa el mayor contraste. Normalmente, un valor en medio del intervalo representa el contraste normal o predeterminado.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_CAPTURE_MODE
CameraDeviceCaptureMode

Establece el modo de captura de imágenes.

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.

Modo de captura Descripción
CAPTUREMODE_NORMAL Modo normal para la cámara.
CAPTUREMODE_BURST Capture más de una imagen en sucesión rápida según lo definido por los valores de las propiedades WIA_DPC_BURST_NUMBER y WIA_DPC_BURST_INTERVAL .
CAPTUREMODE_TIMELAPSE Capture más de una imagen sucesivamente según lo definido por las propiedades WIA_DPC_TIMELAPSE_NUMBER y WIA_DPC_TIMELAPSE_INTERVAL .

 
WIA_DPC_CAPTURE_DELAY
CameraDeviceCaptureDelay

Valor que representa la cantidad de tiempo de retraso, en milisegundos, que se debe insertar entre el desencadenador de captura y el inicio real de la captura de datos. Esta propiedad no está pensada para usarse para describir el tiempo entre fotogramas para inicio único, varias capturas como ráfaga o período de tiempo, que tienen propiedades de intervalo independientes WIA_DPC_BURST_INTERVAL y WIA_DPC_TIMELAPSE_INTERVAL. En esos casos, sigue funcionando como un retraso inicial antes de que se capture la primera imagen de la serie, independientemente del tiempo entre fotogramas. Para ningún retraso de precaptura, esta propiedad debe establecerse en cero.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_EXPOSURE_INDEX
CameraDeviceExposureIndex

Permite la emulación de la configuración de velocidad de película en una cámara digital. La configuración corresponde a las designaciones ISO (ASA/DIN). Normalmente, un dispositivo admite valores enumerados discretos, pero es posible controlar continuamente un intervalo de valores. Un valor de 0xFFFF corresponde a la configuración ISO automática.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_EXPOSURE_METERING_MODE
CameraDeviceExposureMeteringMode

Especifica el modo que usa la cámara para ajustar automáticamente la configuración de exposición.

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

Modo de medición de exposición Descripción
EXPOSUREMETERING_AVERAGE Establezca la exposición en función de un promedio de toda la escena.
EXPOSUREMETERING_CENTERWEIGHT Establezca la exposición en función de un promedio ponderado central.
EXPOSUREMETERING_MULTISPOT Establezca la exposición en función de un patrón multispot.
EXPOSUREMETERING_CENTERSPOT Establezca la exposición en función de un punto central.

 
WIA_DPC_FOCUS_METERING_MODE
CameraDeviceFocusMeteringMode

Especifica el modo que usa la cámara para ajustar automáticamente el foco.

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.

Modo de medición de foco Descripción
FOCUSMETERING_CENTERSPOT Ajuste el foco en función de un punto central.
FOCUSMETERING_MULTISPOT Ajuste el foco en función de un patrón multispot.

 
WIA_DPC_FOCUS_DISTANCE
CameraDeviceFocusDistance

Distancia, en milímetros, entre el plano de captura de imágenes de la cámara digital y el punto de enfoque. Un valor de 0xFFFF corresponde a un valor superior a 655 metros.

Tipo: VT_I4, Access: Lectura y escritura, Valores válidos: WIA_PROP_LIST o WIA_PROP_RANGE
WIA_DPC_FOCAL_LENGTH
CameraDeviceFocalLength

Longitud focal equivalente a 35 mm. Los valores de esta propiedad corresponden a la longitud focal en milímetros multiplicados por 100. La longitud focal determina el zoom óptico.

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

Cadena Unicode terminada en null que representa la ganancia roja, verde y azul aplicada a los datos de imagen, respectivamente. Por ejemplo, "4:25:50" representa una ganancia roja de 4, una ganancia verde de 25 y una ganancia azul de 50.

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

Especifica cómo pondera los canales de color de la cámara digital.

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

A continuación se muestra una lista de valores posibles para esta propiedad.

Balance de blancos Descripción
WHITEBALANCE_MANUAL El balance de blancos se establece directamente mediante la propiedad WIA_DPC_RGB_GAIN .
WHITEBALANCE_AUTO La cámara usa un mecanismo automático para establecer el balance de blancos.
WHITEBALANCE_ONEPUSH_AUTO La cámara determina la configuración de balance de blancos cuando un usuario presiona el botón de captura mientras apunta la cámara en una superficie blanca.
WHITEBALANCE_DAYLIGHT La cámara establece el balance de blancos en un valor adecuado para su uso en condiciones de verano.
WHITEBALANCE_FLORESCENT La cámara establece el balance de blancos en un valor adecuado para su uso con una fuente de luz fluorescente.
WHITEBALANCE_TUNGSTEN La cámara establece el balance de blancos en un valor adecuado para su uso con una fuente de luz de tungsteno.
WHITEBALANCE_FLASH La cámara establece el balance de blancos en un valor adecuado para su uso con un flash electrónico.

 
WIA_DPC_UPLOAD_URL
CameraDeviceUploadURL

Describe una dirección URL. La dirección URL descrita por esta proroperty es aquella en la que se pueden cargar imágenes u objetos, una vez adquiridos desde el dispositivo, según uno de los escenarios siguientes.

  • Una aplicación WIA lee esta propiedad y permite al usuario cargar automáticamente imágenes en la dirección URL.
  • Una aplicación establece la dirección URL y otros dispositivos (quioscos, etc.) usan esta propiedad.

Microsoft Windows no carga imágenes por sí misma.

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

Nombre del propietario ( que es el usuario actual) del dispositivo. El dispositivo usa esta propiedad para rellenar el campo Artist en cada imagen EXIF que captura.

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

Notificación de copyright. El dispositivo usa esta propiedad para rellenar el campo Copyright en cada imagen EXIF que captura.

Tipo: VT_BSTR, Access: Lectura y escritura, 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