KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE
La propiedad del modo de balance 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 Yammer | Establecer | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
| Sí | Sí | Filtro | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
El valor de propiedad (datos de operación) contiene una estructura KSCAMERA_EXTENDEDPROP_HEADER y una estructura 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 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.
Comentarios
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 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 del balance de blancos, 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 balance de blancos en el valor convergente, no intentar volver a equilibrar automáticamente el blanco, hasta que se recibe un nuevo comando de balance de blancos.
Bloquear, sin combinar el modo Auto, un control ya bloqueado debería ser tratado como no operación por el controlador de la cámara. Bloquear, en combinación con el modo automático, un control ya bloqueado debería 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 todas con la misma configuración de balance 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 balance de blancos no cambie en las diferentes fotos.
Obtención de la propiedad
Al responder a una solicitud KSPROPERTY_TYPE_GET, el controlador establece los miembros de KSCAMERA_EXTENDEDPROP_HEADER en lo siguiente.
| Miembro | Valor |
|---|---|
| Versión | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Size | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) |
| Resultado | 0 |
| Funcionalidad | OR de KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL con (modo de procesamiento de vídeo compatible) |
| Flags | Modo de procesamiento de vídeo actual. |
Si no se estableció previamente ningún balance blancos, el controlador establece Marcas en KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (valor predeterminado). Los miembros de la estructura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING que sigue a 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 balance 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)