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	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 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)

Consulte también

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE