DXGK_BRIGHTNESS_SET fonction de rappel (dispmprt.h)
La fonction DxgkDdiSetBrightness définit un nouveau niveau de luminosité.
Syntaxe
DXGK_BRIGHTNESS_SET DxgkBrightnessSet;
NTSTATUS DxgkBrightnessSet(
[in] PVOID Context,
[in] UCHAR Brightness
)
{...}
Paramètres
[in] Context
Handle vers un bloc de contexte associé à un adaptateur d’affichage. La fonction DxgkDdiAddDevice du pilote miniport d’affichage a précédemment fourni ce handle au sous-système du noyau graphique Microsoft DirectX.
[in] Brightness
Valeur de niveau de luminosité à définir.
Valeur retournée
DxgkDdiSetBrightness retourne STATUS_SUCCESS s’il réussit à définir un nouveau niveau de luminosité. Sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.
Remarques
Le pilote de moniteur appelle la fonction DxgkDdiSetBrightness du pilote miniport d’affichage pour modifier le niveau de luminosité du panneau d’affichage intégré pour les raisons suivantes :
- Les notifications du moteur DPPE (Device Power Policy Engine) indiquent que la stratégie actuelle est modifiée ou qu’une nouvelle stratégie prend effet. Une nouvelle stratégie DPPE prend effet au démarrage du système, à la reprise et au changement d’utilisateur, ainsi que lors de la modification de la source d’alimentation.
- La méthode préférée pour les clients en mode utilisateur pour contrôler la luminosité consiste à utiliser Windows Management Instrumentation (WMI). Le pilote de moniteur implémente les contrôles de luminosité WMI qui sélectionnent un niveau de luminosité ou rétablissent le niveau de luminosité sélectionné par la stratégie DPPE actuellement active. La méthode WMI pour sélectionner un niveau de luminosité remplace le niveau de stratégie DPPE actuel jusqu’à ce que toute modification de la stratégie DPPE se produise. Lorsque la stratégie DPPE change, le nouveau niveau DPPE est défini.
- Pour la compatibilité avec le modèle de pilote d’affichage Windows 2000, le pilote de moniteur implémente IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS comme autre moyen pour les clients en mode utilisateur de contrôler la luminosité. Un appel à IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS est géré de la même façon que le contrôle de luminosité WMI qui sélectionne un niveau de luminosité.
- Le pilote du moniteur interprète les notifications de touche d’accès rapide de luminosité du pilote ACPI (Advanced Configuration and Power Interface) lorsque l’utilisateur demande à modifier le niveau de luminosité actuel. Comme avec les interfaces en mode utilisateur WMI et IOCTL, une modification du niveau de luminosité déclenchée par une notification à clé d’accès actif remplace la stratégie DPPE actuelle et reste en vigueur jusqu’à ce que la stratégie DPPE demande que la valeur de luminosité soit à nouveau définie.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |