KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE (normal y secuencia)
El control de la propiedad flash establece la operación de modo flash para el modo de foto normal y secuencia de la cámara.
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_VALUE .
El tamaño total de los datos de propiedad es sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). 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 uno o varios de los siguientes modos flash compatibles con el controlador.
| Modo flash | Descripción |
|---|---|
| KSCAMERA_EXTENDEDPROP_FLASH_OFF | Flash está apagado. |
| KSCAMERA_EXTENDEDPROP_FLASH_ON | Flash está activado en el nivel de intensidad predeterminado. |
| KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER | Flash está encendido en un nivel de potencia específico. |
| KSCAMERA_EXTENDEDPROP_FLASH_AUTO | Flash es automático en función de las condiciones de iluminación. |
| KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER | Flash se basa automáticamente en condiciones de iluminación en un nivel de potencia específico. |
Las siguientes marcas de características se pueden combinar con la configuración flash anterior, excepto para KSCAMERA_EXTENDEDPROP_FLASH_OFF.
| Característica flash | Descripción |
|---|---|
| KSCAMERA_EXTENDEDPROP_FLASH_REDEYEREDUCTION | Habilite la característica de reducción de ojos rojos. Esta marca se puede combinar con cualquier otra configuración. |
| KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH | Establezca flash solo para un desencadenador. Esta característica se omite cuando la cámara no está en modo de secuencia de fotos. |
| KSCAMERA_EXTENDEDPROP_FLASH_MULTIFLASHSUPPORTED | Establezca flash para que se desencadene en cada fotograma de secuencia. Esta característica se omite cuando la cámara no está en modo de secuencia de fotos. |
El miembro Flags de KSCAMERA_EXTENDEDPROP_HEADER contiene el modo flash establecido actualmente para la cámara.
El modo flash predeterminado para una cámara es KSCAMERA_EXTENDEDPROP_FLASH_OFF. Si la cámara admite flash, KSCAMERA_EXTENDEDPROP_FLASH_OFF, KSCAMERA_EXTENDEDPROP_FLASH_ON y KSCAMERA_EXTENDEDPROP_FLASH_AUTO son modos necesarios. Los modos KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER y KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER son opcionales.
Si el modo de secuencia de fotos es compatible con la cámara, la propiedad de control flash es necesaria con compatibilidad para KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH.
Este control de propiedad es sincrónico y no cancelable.
Comentarios
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 | Valor |
|---|---|
| Versión | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Size | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Resultado | 0 |
| Capacidad | Valores de modo Flash admitidos |
| Marcas | (Configuración del valor del modo flash actual) | (marcas de características flash) |
Cuando el modo de antorcha está KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER o KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER, el miembro Value.ull de KSCAMERA_EXTENDEDPROP_VALUE contiene un valor de nivel de intensidad entre 0 y 100. Una intensidad de 0 indica un nivel mínimo y una intensidad de 100 indica un nivel de intensidad máxima. Cuando no se establecen las marcas de potencia ajustables, el valor de la configuración de intensidad normalizada se devuelve en Value.ull.
Si no se estableció previamente ningún modo flash, flags se establece en KSCAMERA_EXTENDEDPROP_FLASH_OFF (valor predeterminado).
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 antorcha que se va a establecer. El miembro Value.ull de KSCAMERA_EXTENDEDPROP_VALUE contendrá el nivel de intensidad que se va a establecer si Flags es KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER o KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER.
Requisitos
Versión: Disponible a partir de Windows 8.1
Rúbrica: Ksmedia.h (incluye Ksmedia.h)