Partager via


Fonction DrvIcmSetDeviceGammaRamp (winddi.h)

La fonction DrvIcmSetDeviceGammaRamp définit la rampe gamma matérielle du périphérique d’affichage spécifié.

Syntaxe

BOOL DrvIcmSetDeviceGammaRamp(
  DHPDEV dhpdev,
  ULONG  iFormat,
  LPVOID lpRamp
);

Paramètres

dhpdev

Gérez le PDEV de l’appareil physique. Cela identifie l’appareil physique dont la rampe gamma doit être définie.

iFormat

Spécifie le format de données de la mémoire tampon vers laquelle lpRamp pointe. Ce paramètre est toujours IGRF_RGB_256WORDS.

lpRamp

Pointeur vers la mémoire tampon contenant la rampe gamma à définir sur l’appareil. Le format des données de cette mémoire tampon est déterminé par iFormat.

Quand iFormat est IGRF_RGB_256WORDS, lpRamp pointe vers une structure GAMMARAMP qui définit les rampes à 256 entrées à définir pour chacun des canaux de couleur rouge, bleu et vert. Chaque valeur est décrite à l’aide d’une précision de 16 bits. Si le matériel a moins de bits de précision, il doit rétrograder et utiliser les bits les plus significatifs, sans arrondir.

Valeur retournée

DrvIcmSetDeviceGammaRamp retourne TRUE en cas de réussite. Sinon, il retourne FALSE.

Remarques

Les pilotes pour les périphériques d’affichage avec des rampes gamma matérielles chargeables doivent implémenter cette fonction.

DrvIcmSetDeviceGammaRamp doit échouer s’il est appelé avec une autre valeur que IGRF_RGB_256WORDS dans iFormat.

Le pilote crochete cette fonction en définissant l’indicateur GCAPS2_CHANGEGAMMARAMP dans le champ flGraphicsCaps2 de la structure DEVINFO passée à DrvEnablePDEV. Si le pilote s’exécute en mode 8bpp palettisé, cette fonctionnalité est facultative.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête winddi.h (inclure Winddi.h)

Voir aussi

DrvEnablePDEV