DXGK_BRIGHTNESS_SET funzione di callback (dispmprt.h)
La funzione DxgkDdiSetBrightness imposta un nuovo livello di luminosità.
Sintassi
DXGK_BRIGHTNESS_SET DxgkBrightnessSet;
NTSTATUS DxgkBrightnessSet(
[in] PVOID Context,
[in] UCHAR Brightness
)
{...}
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 kernel della grafica Microsoft DirectX.
[in] Brightness
Valore del livello di luminosità da impostare.
Valore restituito
DxgkDdiSetBrightness restituisce STATUS_SUCCESS se riesce a impostare un nuovo livello di luminosità. In caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.
Osservazioni
Il driver di monitoraggio chiama il driver miniport DxgkDdiSetBrightness funzione per modificare il livello di luminosità del pannello di visualizzazione integrato per i motivi seguenti:
- Le notifiche dal motore DPPE (Device Power Policy Engine) indicano che il criterio corrente è stato modificato o che un nuovo criterio diventa effettivo. Un nuovo criterio DPPE ha effetto sull'avvio, la ripresa e l'opzione utente del sistema, nonché quando viene modificata l'alimentazione.
- Il modo preferito per i client in modalità utente per controllare la luminosità consiste nell'usare Strumentazione gestione Windows (WMI). Il driver di monitoraggio implementa i controlli di luminosità WMI che selezionano un livello di luminosità o ripristinano il livello di luminosità al livello selezionato dai criteri DPPE attualmente attivi. Il metodo WMI per selezionare un livello di luminosità sostituisce il livello di criteri DPPE corrente fino a quando non si verifica alcuna modifica nei criteri DPPE. Quando cambiano i criteri DPPE, viene impostato il nuovo livello DPPE.
- Per la compatibilità con Modello di driver di visualizzazione di Windows 2000, il driver di monitoraggio implementa IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS come modo alternativo per i client in modalità utente per controllare la luminosità. Una chiamata a IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS viene gestita allo stesso modo del controllo luminosità WMI che seleziona un livello di luminosità.
- Il driver di monitoraggio interpreta le notifiche con tasti di scelta rapida della luminosità dal driver ACPI (Advanced Configuration and Power Interface) mentre l'utente richiede di modificare il livello di luminosità corrente. Come per le interfacce WMI e IOCTL in modalità utente, una modifica del livello di luminosità attivata da una notifica con tasti di scelta rapida sostituisce i criteri DPPE correnti e rimane attiva fino a quando i criteri DPPE non richiede che il valore della luminosità venga nuovamente impostato.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |