DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION función de devolución de llamada (dispmprt.h)

Llamado por el subsistema del kernel de gráficos de Microsoft DirectX para establecer el nivel de optimización que usa el controlador de miniporte de pantalla para controlar el brillo de un panel de pantalla integrado.

Sintaxis

DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION DxgkBrightnessSetBacklightOptimization;

NTSTATUS DxgkBrightnessSetBacklightOptimization(
  [in] PVOID Context,
  [in] DXGK_BACKLIGHT_OPTIMIZATION_LEVEL OptimizationLevel
)
{...}

Parámetros

[in] Context

Identificador de un bloque de contexto asociado a un adaptador de pantalla. La función DxgkDdiAddDevice del controlador de minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de DirectX.

[in] OptimizationLevel

Valor de tipo DXGK_BACKLIGHT_OPTIMIZATION_LEVEL que indica el nivel de optimización del control de brillo.

Valor devuelto

Devuelve STATUS_SUCCESS si se realiza correctamente. De lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.

Comentarios

El controlador de minipuerto de pantalla puede cambiar dinámicamente el nivel de optimización de retroiluminación del panel de visualización integrado en función del contenido actual en la pantalla.

El controlador debe responder a las solicitudes del sistema operativo para cambiar el nivel de optimización de retroiluminación en el parámetro OptimizationLevel . Estas solicitudes se basan en los cambios de estado del sistema.

Una vez que el controlador ha habilitado el brillo adaptable en el panel de pantalla en respuesta a una llamada a la función DxgkDdiSetBrightnessState , no debe deshabilitar el brillo adaptable.

Cuando el controlador pasa de un nivel de optimización de retroiluminación a otro, debe realizar una transición gradual en la configuración de brillo del panel de pantalla integrado. Un ejemplo importante de este tipo de transición es cuando un usuario ajusta los controles de reproducción de vídeo y el sistema operativo responde restableciendo el valor de OptimizationLevel de DxgkBacklightOptimizationDynamic a DxgkBacklightOptimizationDesktop.

La conexión de dispositivos de pantalla adicionales al sistema no debe comprometer la capacidad del controlador para realizar el control de brillo adaptable en el panel de pantalla integrado.

Esta función debe ser paginable.

Requisitos

Consulte también

DXGK_BACKLIGHT_OPTIMIZATION_LEVEL

DxgkDdiAddDevice

DxgkDdiSetBrightnessState