KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT (estrategia de rendimiento de aplicaciones)
Los controladores de cámara pueden optimizar su operación de captura en función de las sugerencias proporcionadas por la aplicación. Esta propiedad informa al controlador para establecer su estrategia de rendimiento en función de la operación que más se utilice. Por ejemplo, cuando se optimiza para foto, el controlador de cámara puede programar el sensor para optimizar la velocidad de exposición del sensor y la resolución para reducir la latencia del desencadenador de captura de fotos a la captura de imágenes. Del mismo modo, cuando se optimiza para vídeo, el controlador de cámara puede programar el sensor para una velocidad de fotogramas más alta, pero con una resolución inferior.
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 una o varias de las siguientes sugerencias de optimización.
| Sugerencia de optimización | Descripción |
|---|---|
| KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO | La operación de cámara está optimizada para fotos |
| KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO | La operación de cámara está optimizada para vídeo |
El miembro Flags de KSCAMERA_EXTENDEDPROP_HEADER contiene la optimización establecida actualmente para la cámara (un valor).
El tipo de optimización predeterminado es KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO. Si el controlador de cámara admite esta propiedad, se deben admitir ambos tipos de optimización.
Este control de propiedad es sincrónico y no cancelable.
Comentarios
Modos de optimización
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO
Todos los controladores de cámara deben estar en este modo hasta que se informe explícitamente para usar el modo KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO. El propósito de este modo es optimizar el hardware de la cámara para las operaciones de fotos. Las operaciones de vídeo deben seguir siendo funcionales en este modo.
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO
Este modo indica que es probable que la cámara se use para las operaciones de vídeo. El controlador de cámara debe optimizar el hardware para las operaciones de vídeo para este modo. Las operaciones de fotos deben ser funcionales, pero hay prioridad de uso de recursos para las operaciones de vídeo.
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 optimización admitidos |
| Marcas | Configuración del valor de optimización actual |
Si no se estableció previamente ningún modo de optimización, el controlador establece Marcas en KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO (valor predeterminado).
Establecimiento de la propiedad
Cuando se establece la propiedad, una solicitud KSPROPERTY_TYPE_SET, el miembro Flags de KSCAMERA_EXTENDEDPROP_HEADER contendrá el modo de optimización que se va a establecer.
Requisitos
Versión: Disponible a partir de Windows 8.1
Rúbrica: Ksmedia.h (incluye Ksmedia.h)