DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION funzione di callback (dispmprt.h)
Chiamato dal sottosistema kernel della grafica Microsoft DirectX per impostare il livello di ottimizzazione usato dal driver miniport 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.
Osservazioni
Il driver di miniport di visualizzazione può modificare dinamicamente il livello di ottimizzazione 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 del backlight nel parametro OptimizationLevel. Tali richieste sono basate sulle modifiche dello stato del sistema.
Dopo che il driver ha abilitato la luminosità adattiva nel pannello di visualizzazione in risposta a una chiamata al DxgkDdiSetBrightnessState funzione, non deve disabilitare la luminosità adattiva.
Quando il driver passa da un livello di ottimizzazione del 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 8 |
| server minimo supportato | Windows Server 2012 |
| piattaforma di destinazione | Desktop |
| intestazione | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |