EngQueryPalette-Funktion (winddi.h)

Die EngQueryPalette-Funktion fragt die angegebene Palette nach ihren Attributen ab.

Syntax

ENGAPI ULONG EngQueryPalette(
  HPALETTE hpal,
  ULONG    *piMode,
  ULONG    cColors,
  ULONG    *pulColors
);

Parameter

hpal

Handle für die palette, die abgefragt werden soll.

piMode

Zeiger auf eine Position, die den Palettenmodus empfängt, wie ursprünglich in EngCreatePalette angegeben.

cColors

Gibt die Anzahl der Einträge im Puffer an, auf die pulColors verweist. Der Rückgabewert hängt davon ab , ob cColors negativ ist.

pulColors

Zeiger auf einen Puffer, der die Farbinformationen der Palette empfängt. Wenn cColors null ist, kann pulColorsNULL sein.

Rückgabewert

Wenn cColors null ist, gibt EngQueryPalette die Anzahl der Paletteneinträge zurück, die im Puffer erforderlich sind, auf den pulColors verweist, um die Farbinformationen der Palette zurückzugeben. Wenn cColors nonzero ist und pulColors nicht NULL ist, gibt EngQueryPalette die Anzahl der Einträge zurück, die in den Puffer geschrieben wurden, auf den pulColors verweist.

Hinweise

Wenn der Palettenmodus PAL_BITFIELDS, PAL_RGB oder PAL_BGR ist und der Puffer, auf den pulColors verweist, groß genug ist, zeigt pulColors auf drei ULONG-Masken, die die roten, grünen und blauen Farbmasken der Palette darstellen.

Wenn der Palettenmodus PAL_INDEXED ist und der Puffer, auf den pulColors zeigt, groß genug ist, enthält pulColors alle 24-Bit-RGB-Werte, die die Palettenfarben darstellen.

Ein Treiber muss testen, ob das flag GCAPS_PALMANAGED vorhanden ist, um zu bestimmen, ob die Farben eine feste oder eine veränderliche Palette darstellen.

EngQueryPalette ist für die Verwendung durch Spiegeln von Treibern vorgesehen, die das Farbformat der primären Anzeige kennen müssen. Ein Spiegelungstreiber ruft diese Funktion in der Regel in seiner DrvEnablePDEV-Routine auf.

Anforderungen

Weitere Informationen

DrvEnablePDEV

EngCreatePalette