DXGK_BRIGHTNESS_GET_POSSIBLE fonction de rappel (dispmprt.h)

Article
05/23/2024

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

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 DxgkDdiAddDevice du pilote miniport d’affichage a 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 pointe le paramètre BrightnessLevels .

[out] BrightnessLevels

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

Valeur retournée

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 de miniport d’affichage doit retourner les niveaux de luminosité dans la mémoire tampon vers laquelle pointe le paramètre BrightnessLevels dans l’ordre suivant :

La première valeur de niveau de luminosité est le niveau de luminosité utilisé par le BIOS lorsque l’ordinateur s’exécute sur l’alimentation secteur.
La deuxième valeur de niveau de luminosité est le niveau de luminosité utilisé par le BIOS lorsque l’ordinateur s’exécute sur alimentation CC.
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 de miniport d’affichage, le système d’exploitation fournit au pilote la mémoire tampon vers laquelle pointe le paramètre BrightnessLevels .

DxgkDdiGetPossibleBrightness doit être rendu paginable.

Configuration requise

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

Voir aussi

DxgkDdiAddDevice

Partager via