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 a un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver di visualizzazione ha precedentemente fornito 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.

Commenti

Il driver di monitoraggio chiama la funzione DxgkDdiSetBrightness del driver display per modificare il livello di luminosità del pannello di visualizzazione integrato per i motivi seguenti:

• Le notifiche dal motore di Power Policy del dispositivo (DPPE) indicano che i criteri correnti vengono modificati o che un nuovo criterio ha effetto. Un nuovo criterio DPPE ha effetto sull'avvio del sistema, riprendere e passare dall'utente, nonché quando viene modificata la fonte di alimentazione.
• Il modo preferito per i client in modalità utente di controllare la luminosità è tramite 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à selezionato dal criterio DPPE attualmente attivo. Il metodo WMI per selezionare un livello di luminosità esegue l'override del livello di criterio DPPE corrente fino a quando non si verifica alcuna modifica nei criteri DPPE. Quando i criteri DPPE cambiano, viene impostato il nuovo livello DPPE.
• Per la compatibilità con windows 2000 Display Driver Model, il driver di monitoraggio implementa IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS come modo alternativo per i client in modalità utente di 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 a chiave rapida luminosità dal driver Advanced Configuration and Power Interface (ACPI) come 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 a chiave rapida esegue l'override dei criteri DPPE correnti e rimane attiva fino a quando i criteri DPPE non richiede che il valore di luminosità venga impostato di nuovo.

Requisiti

Vedi anche

DxgkDdiAddDevice

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS