DXGK_BRIGHTNESS_GET_POSSIBLE fonction de rappel (dispmprt.h)

  • Article

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

[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 retournée

DxgkDdiGetPossibleBrightness retourne STATUS_SUCCESS si elle réussit. Sinon, il 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 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 l’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 Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête dispmprt.h (inclure Dispmprt.h)
IRQL PASSIVE_LEVEL

Voir aussi

DxgkDdiAddDevice