KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE

El cliente utiliza este control de propiedad extendida para controlar el nivel de potencia y el ciclo de trabajo de la linterna de infrarrojos de una cámara IR. Se envía al controlador junto con una estructura de KSCAMERA_EXTENDEDPROP_HEADER estándar seguida de una estructura de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .

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

Comentarios

La solicitud de propiedad contiene una estructura de 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.

A continuación se muestran marcas que se pueden colocar en el KSCAMERA_EXTENDEDPROP_HEADER. Marcas y KSCAMERA_EXTENDEDPROP_HEADER. Campos de funcionalidad . Definen los modos de funcionamiento de la antorcha de IR.

Modo de antorcha	Descripción
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF	Desactivado
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON	Siempre disponible
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATING_FRAME_ILLUMINATION	Activado para todos los demás fotogramas

KSCAMERA_EXTENDEDPROP_IRTORCHMODE siempre es un control sincrónico. El control no tiene ningún comportamiento definido cuando la cámara no está transmitiendo.

Para una solicitud GET, un controlador establece los campos siguientes:

• KSCAMERA_EXTENDEDPROP_HEADER. Funcionalidad con máscara de bits de las marcas anteriores KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX que representan los modos de funcionamiento admitidos por la cámara.
• KSCAMERA_EXTENDEDPROP_HEADER. Marcas en una de las marcas anteriores KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX para indicar el modo de funcionamiento actual.
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Modo a 0.
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Mínimo al nivel de potencia mínimo disponible.
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Máximo al nivel de potencia máximo disponible.
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Paso al incremento mínimo entre los niveles de potencia.
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul al nivel de energía actual. Este valor debe tener como valor predeterminado el mismo nivel de potencia que normalmente usa el control de autenticación facial.

Para una solicitud SET, un controlador usa los siguientes campos:

• KSCAMERA_EXTENDEDPROP_HEADER. Marcas para establecer un modo de funcionamiento.
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul para establecer un nivel de potencia. Este valor no tiene ningún efecto en KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF.

La tabla siguiente contiene las descripciones y los requisitos de los campos de estructura de KSCAMERA_EXTENDEDPROP_HEADER cuando se usa el control de metadatos.

Miembro	Descripción
Versión	Debe ser 1.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).
Size	Debe ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof([KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING](/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-tagkscamera_extendedprop_videoprocsetting)),
Resultado	Este valor se omite para los controles sincrónicos.
Capacidad	Puede ser cualquier combinación de KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF, KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON o KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION. Este campo debe notificar al menos una funcionalidad. El campo debe notificar KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON o KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION o ambos. El valor KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF es opcional.
Marcas	Debe ser una de las marcas notificadas en Funcionalidad. El valor predeterminado debe ser KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON o KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION.

La tabla siguiente contiene las descripciones y los requisitos de los campos de estructura de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING cuando se usa el control de modo de antorcha ir.

Miembro	Descripción
Mode	Sin usar. Debe ser 0.
Min/Max/Step	El paso mínimo/máximo contiene el mínimo, máximo o incremento de la configuración de energía de IR. El controlador debe devolverlos para las operaciones GET. (Max – Min) debe ser uniformemente divisible por Paso. Es posible que el paso no sea cero (0).
VideoProc	Para las operaciones SET, VideoProc.Value.ul debe especificar el nivel de energía dentro del intervalo descrito por el parámetro Min/Max/Step. Para las operaciones GET, el controlador debe devolver el nivel de energía actual.
Reservado	Sin usar. El controlador debe omitirlo.

Requisitos

Encabezado

Ksmedia.h