Fonction EngQueryPalette (winddi.h)
La fonction EngQueryPalette interroge la palette spécifiée pour ses attributs.
Syntaxe
ENGAPI ULONG EngQueryPalette(
HPALETTE hpal,
ULONG *piMode,
ULONG cColors,
ULONG *pulColors
);
Paramètres
hpal
Gérez la palette à interroger.
piMode
Pointeur vers un emplacement qui reçoit le mode palette, comme spécifié à l’origine dans EngCreatePalette.
cColors
Spécifie le nombre d’entrées dans la mémoire tampon vers lesquelles pulColors pointe. La valeur de retour dépend de la valeur négative de cColors .
pulColors
Pointeur vers une mémoire tampon qui reçoit les informations de couleur de palette. Si cColors est égal à zéro, pulColors peut avoir la valeur NULL.
Valeur retournée
Lorsque cColors est égal à zéro, EngQueryPalette retourne le nombre d’entrées de palette requises dans la mémoire tampon vers laquelle pulColors pointe afin de renvoyer les informations de couleur de palette. Lorsque cColors n’est pas nul et que pulColors n’a pas la valeur NULL, EngQueryPalette retourne le nombre d’entrées écrites dans la mémoire tampon vers lesquelles pulColors pointe.
Remarques
Si le mode palette est PAL_BITFIELDS, PAL_RGB ou PAL_BGR et que la mémoire tampon vers laquelle pulColors pointe est suffisamment grande, pulColors pointe vers trois masques ULONG qui représentent les masques de couleur rouge, vert et bleu de la palette.
Si le mode palette est PAL_INDEXED et que la mémoire tampon vers laquelle pulColors pointe est suffisamment grande, pulColors contient toutes les valeurs RVB 24 bits qui représentent les couleurs de la palette.
Un pilote doit tester la présence de l’indicateur GCAPS_PALMANAGED pour déterminer si les couleurs représentent une palette fixe ou modifiable.
EngQueryPalette est destiné à être utilisé par la mise en miroir des pilotes qui ont besoin de connaître le format de couleur de l’affichage principal. Un pilote de mise en miroir appelle généralement cette fonction dans sa routine DrvEnablePDEV .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | winddi.h (inclure Winddi.h) |
| Bibliothèque | Win32k.lib |
| DLL | Win32k.sys |