DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION fonction de rappel (dispmprt.h)

Appelé par le sous-système du noyau graphique Microsoft DirectX pour définir le niveau d’optimisation utilisé par le pilote miniport d’affichage pour contrôler la luminosité d’un panneau d’affichage intégré.

Syntaxe

DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION DxgkBrightnessSetBacklightOptimization;

NTSTATUS DxgkBrightnessSetBacklightOptimization(
  [in] PVOID Context,
  [in] DXGK_BACKLIGHT_OPTIMIZATION_LEVEL OptimizationLevel
)
{...}

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 DirectX.

[in] OptimizationLevel

Valeur de type DXGK_BACKLIGHT_OPTIMIZATION_LEVEL qui indique le niveau d’optimisation du contrôle de luminosité.

Valeur retournée

Retourne STATUS_SUCCESS si elle réussit. Sinon, il retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

Le pilote miniport d’affichage peut modifier dynamiquement le niveau d’optimisation du rétroéclairage du panneau d’affichage intégré en fonction du contenu actuel sur l’écran.

Le pilote doit répondre aux demandes du système d’exploitation pour modifier le niveau d’optimisation du rétro-éclairage dans le paramètre OptimizationLevel . Ces demandes sont basées sur les changements d’état du système.

Une fois que le pilote a activé la luminosité adaptative sur le panneau d’affichage en réponse à un appel à la fonction DxgkDdiSetBrightnessState , il ne doit pas désactiver la luminosité adaptative.

Lorsque le pilote passe d’un niveau d’optimisation de rétro-éclairage à un autre, il doit effectuer une transition progressive dans les paramètres de luminosité du panneau d’affichage intégré. Un exemple important de ce type de transition est quand un utilisateur ajuste les contrôles de lecture vidéo et que le système d’exploitation répond en réinitialisant la valeur OptimizationLevel de DxgkBacklightOptimizationDynamic à DxgkBacklightOptimizationDesktop.

La connexion de périphériques d’affichage supplémentaires au système ne doit pas compromettre la capacité du pilote à effectuer un contrôle de luminosité adaptatif sur le panneau d’affichage intégré.

Cette fonction doit être paginable.

Configuration requise

Voir aussi

DXGK_BACKLIGHT_OPTIMIZATION_LEVEL

DxgkDdiAddDevice

DxgkDdiSetBrightnessState