DrvSetPalette, fonction (winddi.h)

Article
03/04/2024

La fonction DrvSetPalette demande que le pilote réalise la palette pour un appareil spécifié.

Syntaxe

BOOL DrvSetPalette(
  DHPDEV dhpdev,
  PALOBJ *ppalo,
  FLONG  fl,
  ULONG  iStart,
  ULONG  cColors
);

Paramètres

dhpdev

Gérez la structure PDEV de l’appareil physique, qui identifie l’appareil dont la palette doit être réalisée. Ce paramètre est le handle d’appareil retourné à GDI par DrvEnablePDEV.

ppalo

Pointeur vers la structure PALOBJ à partir de laquelle les couleurs (valeurs RVB) doivent être interrogées.

fl

Ensemble d’indicateurs qui fournit des conseils et des options. Ce paramètre peut être la valeur suivante :

Valeur	Signification
SP_DEFAULT	La palette est la palette par défaut complète de l’appareil. Le PALOBJ peut être ignoré, mais contient le contenu correct.

iStart

Spécifie le premier index de palette à remplacer.

cColors

Spécifie le nombre de couleurs à modifier dans la palette matérielle. Les couleurs supplémentaires, au-delà du nombre disponible dans le matériel, peuvent être ignorées. Si cColors est plus petit que la taille de la palette matérielle, définissez uniquement les entrées cColors et laissez les couleurs restantes telles quelles.

Valeur retournée

La valeur de retour est TRUE si la fonction réussit. Sinon, il est FALSE et un code d’erreur est journalisé.

Remarques

Le pilote définit la palette matérielle pour qu’elle corresponde le plus possible aux entrées de la palette donnée.

Seules les palettes indexées sont réalisables. Le RC_PALETTE bit du membre flRasterCaps de la structure GDIINFO spécifie si un appareil a une palette réalisable.

DrvSetPalette est requis pour les pilotes d’affichage qui prennent en charge les palettes réalisables.