Función EngQueryPalette (winddi.h)
La función EngQueryPalette consulta la paleta especificada para sus atributos.
Sintaxis
ENGAPI ULONG EngQueryPalette(
HPALETTE hpal,
ULONG *piMode,
ULONG cColors,
ULONG *pulColors
);
Parámetros
hpal
Controle la paleta que se va a consultar.
piMode
Puntero a una ubicación que recibe el modo de paleta, como se especificó originalmente en EngCreatePalette.
cColors
Especifica el número de entradas del búfer a las que apunta pulColors . El valor devuelto depende de si cColors es negativo.
pulColors
Puntero a un búfer que recibe la información de color de la paleta. Si cColors es cero, pulColors puede ser NULL.
Valor devuelto
Cuando cColors es cero, EngQueryPalette devuelve el número de entradas de paleta necesarias en el búfer al que apunta pulColors para devolver la información de color de la paleta. Cuando cColors es distinto de cero y pulColors no es NULL, EngQueryPalette devuelve el número de entradas escritas en el búfer a las que apunta pulColors .
Comentarios
Si el modo de paleta es PAL_BITFIELDS, PAL_RGB o PAL_BGR y el búfer al que pulColors apunta a es lo suficientemente grande, pulColors apunta a tres máscaras ULONG que representan las máscaras de color rojo, verde y azul de la paleta.
Si el modo de paleta es PAL_INDEXED y el búfer al que pulColors apunta a es lo suficientemente grande, pulColors contiene todos los valores RGB de 24 bits que representan los colores de la paleta.
Un controlador debe probar la presencia de la marca GCAPS_PALMANAGED para determinar si los colores representan una paleta fija o modificable.
EngQueryPalette está diseñado para su uso mediante controladores de creación de reflejo que necesitan conocer el formato de color de la pantalla principal. Normalmente, un controlador de creación de reflejo llama a esta función en su rutina DrvEnablePDEV .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | winddi.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |