KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE
La propiedad del modo de enfoque controla los modos de enfoque automático, manual y preestablecido 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 |
El valor de propiedad (datos de operación) contiene una estructura de KSCAMERA_EXTENDEDPROP_HEADER y una estructura de 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 y enfoque | Descripción |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO | El controlador de cámara usa su propia lógica de procesamiento para el 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. |
| KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS | No hay conjunto de puntos focales convergente. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO | Convergencia focal del intervalo de macros. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL | Convergencia focal del intervalo normal. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE | Convergencia focal de alcance completo. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY | Convergencia focal de intervalo infinito. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL | Intervalo hiperfocal. |
El miembro Flags de KSCAMERA_EXTENDEDPROP_HEADER contiene la marca de procesamiento de vídeo establecida actualmente para la cámara. Si KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO configuración se puede combinar con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.
Este control de propiedad es asincrónico y cancelable.
Comentarios
Modos de procesamiento
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
Esta marca indica que la operación de enfoque automático ha convergido cuando se desencadena el evento de finalización. Al finalizar, y cuando esta marca no es combinada con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK, el foco puede diverge y el controlador de la cámara puede seguir intentando la convergencia. Si se incluye la marca KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK, el foco se bloquea a la primera convergencia y no cambia hasta que se recibe un nuevo comando de enfoque.
Bloqueo, sin combinar el modo Automático, el controlador de cámara debe tratar un control ya bloqueado como no operativo. El bloqueo, en combinación con el modo Automático, un control ya bloqueado debe desencadenar una nueva convergencia.
Esta marca es mutuamente excluyente con las marcas KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL y KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
Manual indica que para este procesamiento de vídeo se proporcionan los valores específicos. Se proporcionan valores específicos al controlador.
Esta marca no debe combinarse con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK o KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK
Cuando se establece esta marca sin una marca de KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO correspondiente, se espera que el controlador de cámara bloquee el estado actual del foco y desencadene el evento de finalización una vez que el foco esté bloqueado. El controlador de cámara no debe variar el estado del foco hasta que se reciba un nuevo comando de enfoque. Si KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO combinar esta marca, el controlador de cámara convergerá en el enfoque automático y bloqueará el foco en ese punto convergente y, a continuación, desencadenará el evento de finalización. Esta marca no debe combinarse con KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS o KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.
Es posible que esta marca no se especifique con una marca de intervalo para el control de foco a menos que se combine con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO. En ese caso, el foco se realiza mediante la marca de intervalo para determinar dónde intentar el examen de enfoque automático. A continuación, tras la convergencia, se bloquea la configuración del foco y se activa el evento de finalización.
KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS
Esta marca indica que el foco es continuo. En este caso, no hay ningún punto de convergencia único para el control de foco. El controlador debe aceptar esta solicitud y completar la operación asincrónica inmediatamente.
Esta marca no debe combinarse con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK o KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.
Este modo es necesario para todos los controladores.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO
Esta marca indica que se debe realizar la convergencia del foco para el intervalo de macros. El controlador determina el intervalo focal exacto. Esta marca se puede combinar con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO y KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL
Esta marca indica que la convergencia del foco debe realizarse para el intervalo normal. El controlador determina el intervalo focal exacto. Esta marca se puede combinar con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO y KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE
Esta marca indica que se debe realizar la convergencia del foco para el intervalo completo. El controlador determina el intervalo focal exacto. Esta marca se puede combinar con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO y KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
Este modo es necesario para todos los controladores.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY
Esta marca indica que la convergencia del foco debe realizarse para el intervalo infinito. El controlador determina el intervalo focal exacto. Esta marca se puede combinar con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO y KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL
Esta marca indica que se debe realizar la convergencia del foco para el intervalo hiperfocal. El controlador determina el intervalo focal exacto. Esta marca se puede combinar con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO y KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
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_VIDEOPROCSETTING) |
| Resultado | 0 |
| Capacidad | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE | (Se admiten los modos de procesamiento de vídeo y enfoque) |
| Marcas | El procesamiento de vídeo actual y el modo de enfoque. |
Si no se estableció previamente ninguna marca de intervalo de foco, el controlador establece Marcas en KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE junto con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (valor predeterminado). Los miembros de la estructura de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING que sigue KSCAMERA_EXTENDEDPROP_HEADER se establecen según los requisitos del modo de enfoque.
El valor VideoProp.Value.ull debe contener la configuración de exposición actual cuando el modo está KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO.
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 enfoque que se va a establecer. El miembro VideoProc.Value de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING debe omitirse cuando Flags contiene las marcas de KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
Requisitos
Versión |
Disponible a partir de Windows 8.1. |
Encabezado |
Ksmedia.h (incluye Ksmedia.h) |