KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE
La propiedad del modo de equilibrio de blancos especifica si el procesamiento automático se produce para el balance de blancos o se usa un valor de temperatura manual en su lugar.
Tabla de resumen de uso
| Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
| Sí | Sí | Filtrar | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
El valor de propiedad (datos de operación) contiene una estructura de KSCAMERA_EXTENDEDPROP_HEADER y una estructura de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .
El tamaño total de los datos de propiedad es sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). El miembro Size de KSCAMERA_EXTENDEDPROP_HEADER se establece en este tamaño total de datos de propiedad.
El miembro Capability de KSCAMERA_EXTENDEDPROP_HEADER contiene una combinación OR bit a bit de una o varias de las siguientes opciones de procesamiento de vídeo.
| Modo de procesamiento | Descripción |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO | El controlador de cámara usa su propia lógica de procesamiento para el vídeo. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL | El controlador de cámara usa un método de procesamiento preestablecido o un método basado en temperatura. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK | El método de procesamiento de vídeo actual está bloqueado. |
El miembro Flags de KSCAMERA_EXTENDEDPROP_HEADER contiene la marca de procesamiento de vídeo establecida actualmente para la cámara. La configuración de KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO se puede combinar con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.
Este control de propiedad es asincrónico y no cancelable.
Observaciones
Modos de procesamiento
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
Esto indica que se admite el procesamiento automático. El controlador usará su lógica interna para optimizar el procesamiento de vídeo. Para una solicitud de KSPROPERTY_TYPE_GET , el miembro VideoProc de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING debe contener el valor determinado del controlador actual para el procesamiento de vídeo. En el caso de Balance blanco, debe contener la temperatura actual en Kelvin. El miembro Mode se omite para la operación automática.
Esta marca se puede combinar con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK como un valor OR bit a bit. Cuando está bloqueado, el comportamiento esperado del controlador de cámara consiste en converger en el balance de blancos y bloquear el valor del saldo blanco en el valor convergente, no intentando volver a equilibrar automáticamente el blanco, hasta que se recibe un nuevo comando de balance de blancos.
Bloqueo, sin combinar el modo Automático, el controlador de cámara debe tratar un control ya bloqueado como no operativo. Bloqueo, en combinación con el modo Automático, un control ya bloqueado debe desencadenar una nueva convergencia.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
Manual indica que para este procesamiento de vídeo se proporcionan los valores específicos. En el caso del balance de blancos, si el miembro Mode de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING indica KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE, VideoProc.Value.ul contendrá el valor de temperatura en grados Kelvin.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK La marca de opción de bloqueo indica que el procesamiento de vídeo actual está bloqueado en cualquier valor programado actualmente. Por ejemplo, una aplicación puede solicitar el modo automático hasta que se determine un balance de blancos específico, en ese momento la aplicación decidirá tomar una secuencia de fotos con la misma configuración de equilibrio de blancos. En tal caso, la aplicación puede especificar la marca KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK . El controlador de cámara garantizará que la información de equilibrio de blancos no cambie en las diferentes fotos.
Obtención de la propiedad
Al responder a una solicitud de KSPROPERTY_TYPE_GET , el controlador establece los miembros del KSCAMERA_EXTENDEDPROP_HEADER en lo siguiente.
| Miembro | Value |
|---|---|
| Versión | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Size | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) |
| Resultado | 0 |
| Capacidad | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL OR con (modo de procesamiento de vídeo compatible) |
| Marcas | Modo de procesamiento de vídeo actual. |
Si no se estableció previamente ningún modo de equilibrio de blancos, el controlador establece Marcas en KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (valor predeterminado). Los miembros de la estructura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING que sigue KSCAMERA_EXTENDEDPROP_HEADER se establecen según los requisitos del modo de procesamiento.
Establecimiento de la propiedad
Cuando se establece la propiedad, una solicitud de KSPROPERTY_TYPE_SET, el miembro Flags de KSCAMERA_EXTENDEDPROP_HEADER contendrá el modo de equilibrio de blancos que se va a establecer. El miembro VideoProc.Value de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING debe omitirse cuando Flags contiene la marca de modo KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO.
Requisitos
Versión: Disponible a partir de Windows 8.1
Encabezado: ksmedia.h (incluya Ksmedia.h)
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de