Compartir a través de

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM

  • Artículo

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM es un identificador de propiedad que se usará para controlar los metadatos del histograma generados por el controlador. Se trata de un control de nivel de patilla solo para el pin de vista previa.

Tabla de resumen de uso

Ámbito Control Tipo

versión 1

Anclar

Sincrónico

Las marcas siguientes se pueden colocar en el KSCAMERA_EXTENDEDPROP_HEADER. Marca el campo para controlar los metadatos del histograma en el controlador. El valor predeterminado es HISTOGRAM_OFF.

#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_ON       0x0000000000000001

Este control debe usarse antes de que se asigne el control KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA para asegurarse de que se asigne el búfer de metadatos de tamaño adecuado.

Si se establece en HISTOGRAM_OFF, el controlador no entregará los metadatos del histograma en el pin de vista previa. El controlador no debe incluir el tamaño de metadatos del histograma en su requisito de tamaño del búfer de metadatos.

Si se establece en HISTOGRAM_ON, el controlador entregará los metadatos del histograma en el pin de vista previa. El controlador debe incluir el tamaño de metadatos del histograma en su requisito de tamaño del búfer de metadatos.

Si el controlador no tiene la capacidad de generar metadatos de histograma, el controlador no debe implementar este control. Si el controlador admite este control, también debe admitir KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA control.

La llamada SET de este control no tiene ningún efecto cuando el pin de vista previa está en cualquier estado superior al estado KSSTATE_STOP. El conductor rechazará la llamada SET recibida si la vista previa no está en estado de detención y devuelve STATUS_INVALID_DEVICE_STATE. En una llamada GET , el controlador debe devolver la configuración actual en el campo Marcas .

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

Miembro Descripción

Versión

Debe ser 1.

PinId

Debe ser el identificador de pin asociado al pin de vista previa.

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 0.

Marcas

Se trata de un campo de lectura y escritura. Puede ser cualquiera de las marcas KSCAMERA_EXTENDEDPROP_HISTOGRAM_* definidas anteriormente.

Requisitos

Encabezado

 Ksmedia.h