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 que le pilote miniport d’affichage utilise 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 vers un bloc de contexte associé à un adaptateur d’affichage. La fonction d’affichage du pilote miniport DxgkDdiAddDevice précédemment fourni ce handle 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 de retour
Retourne STATUS_SUCCESS si elle réussit. Sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.
Remarques
Le pilote de 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 des modifications d’état 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, elle 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 lorsqu’un utilisateur ajuste les contrôles de lecture vidéo et que le système d’exploitation répond en réinitialisant la valeur de OptimizationLevel de DxgkBacklightOptimizationDynamic à DxgkBacklightOptimizationDesktop.
La connexion d’appareils 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 rendue paginable.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| serveur minimum pris en charge | Windows Server 2012 |
| plateforme cible | Bureau |
| d’en-tête | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |