KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE
El modo torch determina cómo se usa el flash de una cámara en condiciones de poca luz. El flash proporciona continuamente una fuente de luz de menor intensidad para permitir suficiente luz para operaciones como el enfoque automático.
Tabla de resumen de uso
| Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
Sí |
Sí |
Filtrar |
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 de antorcha admitidos por el controlador.
| Modo de antorcha | Descripción |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF | Torchlight está apagado. |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON | Torchlight está activado en el nivel de intensidad predeterminado. |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER | Torchlight está encendido en un nivel de potencia específico. |
El miembro Flags de KSCAMERA_EXTENDEDPROP_HEADER contiene el modo de antorcha establecido actualmente para la cámara. El modo de antorcha predeterminado para una cámara es KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF y el controlador debe admitir este modo de antorcha.
Este control de propiedad es sincrónico y no se puede cancelar.
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 | Se admiten los valores del modo Torch. |
| Marcas | Valor del modo de antorcha actual (solo un valor). |
Cuando el modo de antorcha está KSCAMERA_EXTENDEDPROP_VIDEOTORCH_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.
Si no se estableció previamente ningún modo de escena, flags se establece en KSCAMERA_EXTENDEDPROP_VIDEOTORCH_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_VIDEOTORCH_ON_ADJUSTABLEPOWER.
Requisitos
Versión |
Disponible a partir de Windows 8.1. |
Encabezado |
Ksmedia.h (incluye Ksmedia.h) |