DXGK_BRIGHTNESS_SET fonction de rappel (dispmprt.h)

  • Article

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 d’un bloc de contexte associé à une carte d’affichage. La fonction DxgkDdiAddDevice du pilote miniport d’affichage fournissait précédemment cette poignée 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, il retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

Le pilote de moniteur appelle la fonction DxgkDdiSetBrightness du pilote 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 sur le démarrage, la reprise et le changement d’utilisateur du système, ainsi que lorsque la source d’alimentation est modifiée.
  • Le moyen préféré pour les clients en mode utilisateur de 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é au niveau sélectionné par la stratégie DPPE actuellement active. La méthode WMI permettant de 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.
  • À des fins de 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 manière que le contrôle de luminosité WMI qui sélectionne un niveau de luminosité.
  • Le pilote de moniteur interprète les notifications de touche chaude de luminosité du pilote ACPI (Advanced Configuration and Power Interface) comme des demandes de l’utilisateur pour modifier le niveau de luminosité actuel. Comme pour les interfaces en mode utilisateur WMI et IOCTL, une modification du niveau de luminosité déclenchée par une notification à clé chaude 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.
DxgkDdiSetBrightness doit être rendu paginable.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête dispmprt.h (inclure Dispmprt.h)
IRQL PASSIVE_LEVEL

Voir aussi

DxgkDdiAddDevice

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS