DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION fonction de rappel (dispmprt.h)

  • Article

Récupère le niveau actuel de réduction du rétroéclairage appliqué au panneau d’affichage intégré.

Syntaxe

DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION DxgkBrightnessGetBacklightReduction;

NTSTATUS DxgkBrightnessGetBacklightReduction(
  [in]  PVOID Context,
  [out] DXGK_BACKLIGHT_INFO *BacklightInfo
)
{...}

Paramètres

[in] Context

Handle d’un bloc de contexte DxgkDdiAddDevice associé à une carte d’affichage. La fonction du pilote miniport d’affichage fournissait précédemment cette poignée au sous-système du noyau graphique DirectX.

[out] BacklightInfo

Valeur de type DXGK_BACKLIGHT_INFO qui fournit le niveau absolu actuel de réduction du rétroéclairage.

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

Cette fonction est principalement utilisée à des fins de débogage et de test afin de garantir une expérience utilisateur de qualité avec le panneau d’affichage. Le pilote miniport d’affichage doit toujours fournir des informations précises sur le panneau d’affichage intégré lorsque cette fonction est appelée.

Notez que pour certains matériels, la valeur zéro pour BacklightInfo-BacklightUsersetting> ou BacklightInfo-BacklightEffective> peut ne pas correspondre à un niveau de luminosité Windows de zéro %. Le système d’exploitation nécessite donc des informations de luminosité absolues fournies par BacklightUsersetting et BacklightEffective. Si le matériel utilise des niveaux de luminosité de 0 à 255, il doit multiplier ces valeurs par 256 pour les mapper correctement à la plage de 0 à 65535 de BacklightUsersetting et BacklightEffective.

Cette fonction doit être paginable.

Calcul du rapport de réduction du rétroéclairage

Le rapport de réduction du rétroéclairage (BRR) est calculé comme (BacklightUsersetting - BacklightEffective) / BacklightUsersetting.

Le système d’exploitation suppose que, en réponse à une nouvelle demande de niveau de luminosité, le pilote augmente la luminosité des pixels par un facteur backlightUsersetting / BacklightEffective = 1.0 / (1.0 - BRR).

Par exemple, si BRR = 0,2, le pilote augmente généralement la luminosité d’un facteur de 1.0 / (1.0 - BRR) = 1.25, de sorte que tous les pixels dont la valeur de luminosité est supérieure à 255 * (1.0 - BRR) = 204 saturent. À l’aide de la valeur de BacklightInfo-GammaRamp> fournie par le pilote, le système d’exploitation peut estimer plus précisément la distorsion de la luminosité des pixels pour une image particulière.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8
Serveur minimal pris en charge Windows Server 2012
Plateforme cible Desktop (Expérience utilisateur)
En-tête dispmprt.h (inclure Dispmprt.h)
IRQL PASSIVE_LEVEL

Voir aussi

DXGK_BACKLIGHT_INFO

DxgkDdiAddDevice