función XLATEOBJ_cGetPalette (winddi.h)

La función XLATEOBJ_cGetPalette recupera los colores RGB o el formato de los campos de bits de la paleta especificada.

Sintaxis

ENGAPI ULONG XLATEOBJ_cGetPalette(
       XLATEOBJ *pxlo,
  [in] ULONG    iPal,
       ULONG    cPal,
       ULONG    *pPal
);

Parámetros

pxlo

Puntero a la estructura XLATEOBJ de la que GDI recupera la información solicitada.

[in] iPal

Identifica la información de paleta que se va a escribir. Este parámetro puede ser uno de los valores siguientes:

Valor	Significado
XO_DESTBITFIELDS	GDI recupera el formato de los campos de bits de la paleta de destino.
XO_DESTPALETTE	GDI recupera los colores RGB de la paleta de destino.
XO_SRCBITFIELDS	GDI recupera el formato de los campos de bits de la paleta de origen.
XO_SRCPALETTE	GDI recupera los colores RGB de la paleta de origen.

cPal

Especifica el número de entradas del búfer a las que apunta pPal. Puede ser menor que el tamaño total de la paleta.

pPal

Puntero a un búfer en el que GDI escribe la información de paleta solicitada. Si iPal es XO_SRCPALETTE o XO_DESTPALETTE y el tipo de paleta correspondiente es PAL_INDEXED, cada entrada es un valor RGB de 24 bits.

Si iPal es XO_SRCBITFIELDS o XO_DESTBITFIELDS y el tipo de paleta correspondiente es PAL_BITFIELDS, PAL_RGB o PAL_BGR, pPal apunta a tres máscaras de ULONG que representan las máscaras de color rojo, verde y azul.

Valor devuelto

XLATEOBJ_cGetPalette devuelve el número de entradas escritas si pPal no es null. Se devuelve un valor de cero si XLATEOBJ es null o su paleta no es válida. XLATEOBJ_cGetPalette también devolverá cero si los datos a los que apunta pxlo no son coherentes con el valor de iPal. Por ejemplo, si los datos a los que apunta es un campo de bits, pero iPal se establece en XO_SRCPALETTE o XO_DESTPALETTE, XLATEOBJ_cGetPalette devolverá cero. Del mismo modo, si los datos a los que apunta pxlo es una paleta, pero iPal se establece en XO_SRCBITFIELDS o XO_DESTBITFIELDS, XLATEOBJ_cGetPalette también devuelve cero.

Comentarios

El controlador debe tener información sobre la paleta para realizar algunos métodos de combinación de colores.

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

Consulte también

XLATEOBJ