Función DrvSetPalette (winddi.h)

Artículo
03/04/2024

La función DrvSetPalette solicita que el controlador obtenga la paleta de un dispositivo especificado.

Sintaxis

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

Parámetros

dhpdev

Controle la estructura PDEV del dispositivo físico, que identifica el dispositivo cuya paleta se va a realizar. Este parámetro es el identificador de dispositivo devuelto a GDI por DrvEnablePDEV.

ppalo

Puntero a la estructura PALOBJ desde la que se deben consultar los colores (valores RGB).

fl

Conjunto de marcas que proporciona sugerencias y opciones. Este parámetro puede ser el siguiente valor:

Valor	Significado
SP_DEFAULT	La paleta es la paleta predeterminada completa del dispositivo. PaloBJ se puede omitir, pero contiene el contenido correcto.

iStart

Especifica el primer índice de paleta que se va a sobrescribir.

cColors

Especifica el número de colores que se van a cambiar en la paleta de hardware. Se pueden omitir colores adicionales, más allá del número disponible en el hardware. Si cColors es menor que el tamaño de la paleta de hardware, establezca solo entradas cColors y deje los colores restantes tal cual.

Valor devuelto

El valor devuelto es TRUE si la función es correcta. De lo contrario, es FALSE y se registra un código de error.

Comentarios

El controlador establece la paleta de hardware para que coincida con las entradas de la paleta especificada lo más cerca posible.

Solo las paletas indizadas son realizables. El RC_PALETTE bit del miembro flRasterCaps de la estructura GDIINFO especifica si un dispositivo tiene una paleta realizable.

DrvSetPalette es necesario para los controladores de pantalla que admiten paletas realizables.