KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR

KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR se usa para habilitar o deshabilitar vídeo de alto rango dinámico (HDR) en el controlador. Se trata de un control de nivel de patilla solo para el pin de vídeo.

Tabla de resumen de uso

Obtener Set Destino Tipo de descriptor de propiedad
Anclar KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR

Las marcas siguientes se pueden colocar en el KSCAMERA_EXTENDEDPROP_HEADER. Campo De marcas para controlar video HDR. De forma predeterminada, el controlador debe establecerse en VIDEOHDR_OFF.

#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON       0x0000000000000001 
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO     0x0000000000000002 

Si el controlador admite este control, debe admitir VIDEOHDR_ON/VIDEOHDR_OFF.

Si el controlador no admite video HDR, el controlador no debe implementar este control.

Este control actúa como sugerencia para el controlador. Cuando se establece en VIDEOHDR_ON, el controlador debe realizar video HDR como el mejor esfuerzo.

La llamada SET de este control no tiene ningún efecto cuando el pin de vídeo está KSSTATE_RUN estado. El controlador rechazará la llamada SET recibida si el pin de vídeo está en estado de ejecución y devuelve STATUS_INVALID_DEVICE_STATE. En una llamada GET, el controlador debe devolver la configuración actual en el campo Marcas.

En la tabla siguiente se describen las funcionalidades de marca.

Marca Descripción
KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF Se trata de una funcionalidad obligatoria. Cuando se especifica, el vídeo HDR está deshabilitado en el controlador y el controlador no realizará video HDR en la secuencia de vídeo.
KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON Se trata de una funcionalidad obligatoria. Cuando se especifica, el vídeo HDR está habilitado en el controlador y el controlador realizará video HDR como mejor esfuerzo. Esta marca es mutuamente excluyente con las marcas VIDEOHDR_AUTO y VIDEOHDR_OFF.
KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO Esta funcionalidad es opcional. Cuando se especifica, el controlador que admite dicha funcionalidad determinará si el HDR de vídeo se debe realizar en función del análisis de la escena. Esta marca es mutuamente excluyente con las marcas VIDEOHDR_ON y VIDEOHDR_OFF.

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

Member Descripción
Versión Debe ser 1.
PinId Debe ser el identificador de pin asociado al pin de vídeo.
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 OR bit a bit de las marcas admitidas KSCAMERA_EXTENDEDPROP_VIDEOHDR_* definidas anteriormente.
Marcas Se trata de un campo de lectura y escritura. Puede ser cualquiera de las marcas KSCAMERA_EXTENDEDPROP_VIDEOHDR_* definidas anteriormente.

Requisitos

Cliente mínimo admitido: Windows 11

Encabezado: ksmedia.h (incluya Ksmedia.h)

Consulte también

2.2.2.13 Video HDR Control