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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 |
| Servidor mínimo compatible | Windows Server 2012 |
| Plataforma de destino | Escritorio |
| Encabezado | dispmprt.h (incluir Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |