DXGK_BRIGHTNESS_GET_POSSIBLE fonction de rappel (dispmprt.h)

Article
02/06/2025

La fonction DxgkDdiGetPossibleBrightness récupère les niveaux de luminosité qu’un panneau d’affichage intégré prend en charge.

Syntaxe

DXGK_BRIGHTNESS_GET_POSSIBLE DxgkBrightnessGetPossible;

NTSTATUS DxgkBrightnessGetPossible(
  [in]  PVOID Context,
  [in]  ULONG BufferSize,
  [out] PUCHAR LevelCount,
  [out] PUCHAR BrightnessLevels
)
{...}

Paramètres

[in] Context

[in] 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 Microsoft DirectX.

[in] BufferSize

[in] Taille, en octets, de la mémoire tampon passée dans le paramètre BrightnessLevels.

[out] LevelCount

[out] Pointeur vers une variable qui reçoit le nombre de niveaux de luminosité que le pilote retourne dans la mémoire tampon vers laquelle le paramètre BrightnessLevels pointe.

[out] BrightnessLevels

[in/out] Pointeur vers une mémoire tampon qui reçoit les niveaux de luminosité pris en charge par un panneau d’affichage intégré.

Valeur de retour

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

Remarques

Le pilote miniport d’affichage doit retourner des niveaux de luminosité dans la mémoire tampon vers laquelle le paramètre BrightnessLevels pointe dans l’ordre suivant :

La première valeur de niveau de luminosité est le niveau de luminosité que le BIOS utilise lorsque l’ordinateur s’exécute sur l’alimentation ac.
La deuxième valeur de niveau de luminosité est le niveau de luminosité que le BIOS utilise lorsque l’ordinateur s’exécute sur l’alimentation du contrôleur de domaine.
Les valeurs de niveau de luminosité restantes sont des niveaux de luminosité pris en charge par le matériel.

Pour simplifier votre travail d’implémentation d’un pilote miniport d’affichage, le système d’exploitation fournit au pilote la mémoire tampon vers laquelle le paramètre BrightnessLevels pointe.

DxgkDdiGetPossibleBrightness doit être rendu paginable.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
plateforme cible	Bureau
d’en-tête	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL

Voir aussi

DxgkDdiAddDevice

Partager via