Compartir a través de


KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION

KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION es un identificador de propiedad que se usa para informar al controlador de si la cámara está orientada hacia delante o no, en relación con la pantalla activa de la aplicación. Windows establecerá la propiedad cuando se establezca la nueva propiedad api de WinRT PanelBasedOptimizationControl.Panel.

Puede encontrar ejemplos de configuración de controles KSProperty en avStream Camera Sample Driver en GitHub.

Tabla de resumen de uso

Obtener Set Destino Tipo de descriptor de propiedad Tipo de valor de propiedad
Filtrar KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

Observaciones

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

A continuación se muestran marcas que se pueden colocar en el KSCAMERA_EXTENDEDPROP_HEADER. Marcas y KSCAMERA_EXTENDEDPROP_HEADER. Campos de funcionalidad .

Modo de optimización de panel relativo Descripción
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF La cámara usará el modo normal de funcionamiento
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON La cámara usará la optimización con respecto a una posición descrita en el campo de valor.
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC La sugerencia de ubicación de la cámara se puede ajustar dinámicamente mientras se transmite sin deslizar la secuencia

KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION siempre es un control sincrónico.

Cualquier aplicación puede leer la propiedad, pero solo las aplicaciones que han abierto la cámara para acceso exclusivo pueden escribir en el valor de la propiedad.

Se devolverá un código de error adecuado si se intentan escribir la propiedad sin tener acceso al modo exclusivo.

En lo que respecta a la asignación de esta DDI al PanelBasedOptimizationControl, la aplicación que usa PanelBasedOptimizationControl establecerá el valor del Panel, que Windows usará internamente para programar el campo KSCAMERA_EXTENDEDPROP_VALUE de la carga.

Windows controlará el campo Funcionalidad y marcas .

Si el controlador recibe una operación SET mientras el dispositivo de cámara está transmitiendo y la marca KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC* no está establecida, el controlador devolverá un error basado en estado.

La tabla siguiente contiene 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_VALUE)
Resultado Indica los resultados del error de la última operación SET. Si no se ha realizado ninguna operación SET, debe ser 0.
Capacidad Debe ser un poco inteligente O de las marcas de KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_XXX admitidas definidas anteriormente.
Marcas Se trata de un campo de lectura y escritura. Esto puede ser KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON o KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF marcas definidas anteriormente.

Si KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON se especifica en el campo Marcas del KSCAMERA_EXTENDEDPROP_HEADER, el campo Value.ul debe especificar el PLD para la dirección relativa a la que se encuentra actualmente la cámara.

Puede ser cualquiera de los valores de enumeración para ACPI PLD, pero con más frecuencia será Front, Back o Unknown.

Si se especifica KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF , para las operaciones SET, se omite el campo Valor .

Para las operaciones GET, el controlador debe devolver la dirección para la que la cámara está programada actualmente.

Si se especifica KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF o si no se ha establecido ningún valor, se debe devolver el PLD predeterminado del dispositivo.

Si se especifica KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON , se debe devolver el valor establecido más recientemente.

Requisitos

Encabezado: ksmedia.h (incluya Ksmedia.h)