Expand Minimize

EngQueryPalette function

The EngQueryPalette function queries the specified palette for its attributes.

Syntax


ULONG EngQueryPalette(
  HPALETTE hPal,
  ULONG *piMode,
  ULONG cColors,
  ULONG *pulColors
);

Parameters

hPal

Handle to the palette to be queried.

piMode

Pointer to a location that receives the palette mode, as originally specified in EngCreatePalette.

cColors

Specifies the number of entries in the buffer to which pulColors points. The return value depends on whether cColors is negative.

pulColors

Pointer to a buffer that receives the palette color information. If cColors is zero, pulColors can be NULL.

Return value

When cColors is zero, EngQueryPalette returns the number of palette entries required in the buffer to which pulColors points in order to return the palette color information. When cColors is nonzero and pulColors is not NULL, EngQueryPalette returns the number of entries written in the buffer to which pulColors points.

Remarks

If the palette mode is PAL_BITFIELDS, PAL_RGB, or PAL_BGR and the buffer that pulColors points to is large enough, pulColors points to three ULONG masks that represent the red, green, and blue color masks of the palette.

If the palette mode is PAL_INDEXED and the buffer that pulColors points to is large enough, pulColors contains all of the 24-bit RGB values that represent the palette colors.

A driver must test for the presence of the GCAPS_PALMANAGED flag to determine whether the colors represent a fixed or a changeable palette.

EngQueryPalette is intended for use by mirroring drivers that need to know the color format of the primary display. A mirroring driver typically calls this function in its DrvEnablePDEV routine.

Requirements

Version

Available in Windows 2000 and later versions of the Windows operating systems.

Header

Winddi.h (include Winddi.h)

Library

Win32k.lib

DLL

Win32k.sys

See also

EngCreatePalette
DrvEnablePDEV

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft