DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION funzione di callback (dispmprt.h)

Chiamato dal sottosistema kernel grafico Microsoft DirectX per impostare il livello di ottimizzazione usato dal driver miniport di visualizzazione per controllare la luminosità di un pannello di visualizzazione integrato.

Sintassi

DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION DxgkBrightnessSetBacklightOptimization;

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

Parametri

[in] Context

Handle di un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver miniport di visualizzazione ha fornito in precedenza questo handle al sottosistema del kernel grafico DirectX.

[in] OptimizationLevel

Valore di tipo DXGK_BACKLIGHT_OPTIMIZATION_LEVEL che indica il livello di ottimizzazione del controllo della luminosità.

Valore restituito

Restituisce STATUS_SUCCESS se ha esito positivo. In caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Commenti

Il driver miniport di visualizzazione può modificare dinamicamente il livello di ottimizzazione della backlight del pannello di visualizzazione integrato in base al contenuto corrente sullo schermo.

Il driver deve rispondere alle richieste del sistema operativo per modificare il livello di ottimizzazione della backlight nel parametro OptimizationLevel . Tali richieste si basano sulle modifiche dello stato del sistema.

Dopo che il driver ha abilitato la luminosità adattiva nel pannello di visualizzazione in risposta a una chiamata alla funzione DxgkDdiSetBrightnessState , non deve disabilitare la luminosità adattiva.

Quando il driver passa da un livello di ottimizzazione della backlight a un altro, dovrebbe eseguire una transizione graduale nelle impostazioni di luminosità del pannello di visualizzazione integrato. Un esempio importante di questo tipo di transizione è quando un utente regola i controlli di riproduzione video e il sistema operativo risponde reimpostando il valore di OptimizationLevel da DxgkBacklightOptimizationDynamic a DxgkBacklightOptimizationDesktop.

La connessione di dispositivi di visualizzazione aggiuntivi al sistema non deve compromettere la capacità del driver di eseguire il controllo della luminosità adattiva nel pannello di visualizzazione integrato.

Questa funzione deve essere resa pageable.

Requisiti

Vedi anche

DXGK_BACKLIGHT_OPTIMIZATION_LEVEL

DxgkDdiAddDevice

DxgkDdiSetBrightnessState