Propiedades extendidas del control de cámara

La interfaz de control de cámara extendida, disponible a partir de Windows 8, se usa para controlar las características de la cámara durante la captura de imágenes. El controlador puede controlar estas características de cámara:

• el flash de la cámara
• si el pin de imagen y el pin de registro son mutuamente excluyentes
• la región de interés de la imagen
• estabilización de vídeo

El controlador también puede optar por realizar una operación de control de cámara de forma asincrónica, lo que significa que todas las solicitudes de una operación se rechazan hasta que se complete la primera solicitud. Si el controlador ha realizado correctamente operaciones de control de cámara asincrónicas, debe desencadenar el evento KSEVENTSETID_CameraAsyncControl . Consulte KSPROPERTY_CAMERACONTROL_S_EX para obtener más información.

Las aplicaciones para UWP pueden acceder a estas propiedades para configurar la cámara:

Propiedades

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY
Se usa para activar o desactivar el flash de la cámara, o para poner el flash en modo automático.

KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_PROPERTY
Se usa para identificar si el pin de imagen y el pin de grabación de la cámara son mutuamente excluyentes.

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY
Se usa para obtener o establecer la característica de la región de interés de una cámara.

KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE_PROPERTY
Se usa para obtener o establecer las características de estabilización de vídeo de una cámara.

Las siguientes propiedades están disponibles a partir de Windows 8.1.

Término	Descripción
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE	Se usa para obtener o establecer un modo normal de secuencia de fotos o todavía para la cámara.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOFRAMERATE	Se usa para obtener la velocidad de fotogramas de captura de fotos actual cuando el modo de foto para la cámara es el modo de secuencia.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE	Se usa para obtener o establecer la velocidad máxima de fotogramas de captura para una cámara cuando está en modo de secuencia de fotos.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTRIGGERTIME	Se usa para obtener o establecer la hora del desencadenador para el controlador de cámara.
KSPROPERTY_CAMERACONTROL_EXTENDED_WARMSTART	Se usa para obtener o establecer el estado de inicio intermedio (listo para la cámara).
KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES	Se usa para obtener o establecer la velocidad de fotogramas máxima posible en las patillas de captura de vídeo en una determinada resolución.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL	Se usa para obtener o establecer la funcionalidad de miniatura de la cámara.
KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE	Se usa para obtener o establecer un modo definido por el controlador que representa una colección de controles preestablecidos.
KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE	Se usa para obtener o establecer el método en el que se usa el flash de una cámara en condiciones de poca luz.
KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE	Se usa para obtener o establecer la operación de modo flash para el modo de foto normal y secuencia de la cámara.
KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT	Se usa para obtener o establecer si el procesamiento automático se produce para el balance de blancos o para un valor de temperatura manual.
KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE	Se usa para obtener o establecer si la cámara está optimizada para la operación de foto o vídeo.
KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE	Se usa para obtener o establecer si se produce el procesamiento automático para la exposición o se usa un valor de tiempo manual.
KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE	Se usa para obtener o establecer los modos de enfoque automático, manual y preestablecido de la cámara.
KSPROPERTY_CAMERACONTROL_EXTENDED_ISO	Se usa para obtener o establecer la configuración ISO preestablecida o automática de la cámara.
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW	Se usa para obtener el campo de vista y ángulo de inclinación de la posición de la cámara.
KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION	Se usa para obtener o establecer la configuración de ajuste del control de exposición.
KSPROPERTY_CAMERACONTROL_EXTENDED_CAMERAANGLEOFFSET	Se usa para obtener el ángulo de inclinación y giro de la posición de la cámara.

Estas estructuras y enumeraciones admiten la interfaz de control de cámara extendida:

Estructuras

• KSPROPERTY_CAMERACONTROL_S_EX
• KSPROPERTY_CAMERACONTROL_FLASH_S
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_S
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S
• KSPROPERTY_CAMERACONTROL_VIDEOSTABILIZATION_MODE_S
• KSCAMERA_EXTENDEDPROP_HEADER
• KSCAMERA_EXTENDEDPROP_VALUE
• KSCAMERA_EXTENDEDPROP_PHOTOMODE
• KSCAMERA_MAXVIDEOFPS_FORPHOTORES
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING
• KSCAMERA_EXTENDEDPROP_FIELDOFVIEW

Enumeraciones

• KS_CameraControlAsyncOperation
• KSEVENT_CAMERACONTROL
• KSPROPERTY_CAMERACONTROL_FLASH
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST
• KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE

El código de controlador de ejemplo que implementa esta interfaz se ofrece en Cómo implementar propiedades de control de cámara extendidas.