XLATEOBJ_cGetPalette-Funktion (winddi.h)

Artikel
08/27/2023

Die XLATEOBJ_cGetPalette-Funktion ruft RGB-Farben oder das Bitfeldformat aus der angegebenen Palette ab.

Syntax

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

Parameter

pxlo

Zeiger auf die XLATEOBJ-Struktur , aus der GDI die angeforderten Informationen abruft.

[in] iPal

Gibt die zu schreibenden Paletteninformationen an. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
XO_DESTBITFIELDS	GDI ruft das Bitfeldformat der Zielpalette ab.
XO_DESTPALETTE	GDI ruft RGB-Farben aus der Zielpalette ab.
XO_SRCBITFIELDS	GDI ruft das Bitfeldformat der Quellpalette ab.
XO_SRCPALETTE	GDI ruft RGB-Farben aus der Quellpalette ab.

cPal

Gibt die Anzahl der Einträge im Puffer an, auf die pPal verweist. Dies kann kleiner als die Gesamtgröße der Palette sein.

pPal

Zeiger auf einen Puffer, in den GDI die angeforderten Paletteninformationen schreibt. Wenn iPal XO_SRCPALETTE oder XO_DESTPALETTE ist und der jeweilige Palettentyp PAL_INDEXED ist, ist jeder Eintrag ein 24-Bit-RGB-Wert.

Wenn iPal XO_SRCBITFIELDS oder XO_DESTBITFIELDS ist und der jeweilige Palettentyp PAL_BITFIELDS, PAL_RGB oder PAL_BGR ist, verweist pPal auf drei ULONG-Masken, die die roten, grünen und blauen Farbmasken darstellen.

Rückgabewert

XLATEOBJ_cGetPalette gibt die Anzahl der geschriebenen Einträge zurück, wenn pPal nicht NULL ist. Ein Wert von null wird zurückgegeben, wenn der XLATEOBJ NULL oder seine Palette ungültig ist. XLATEOBJ_cGetPalette gibt auch null zurück, wenn die daten, auf die von pxlo verwiesen wird, nicht mit dem Wert in iPal konsistent sind. Wenn beispielsweise die Daten, auf die verwiesen wird, ein Bitfeld sind, iPal jedoch entweder auf XO_SRCPALETTE oder XO_DESTPALETTE festgelegt ist, gibt XLATEOBJ_cGetPalette null zurück. Wenn die daten, auf die von pxlo verwiesen wird, eine Palette sind, iPal jedoch entweder auf XO_SRCBITFIELDS oder XO_DESTBITFIELDS festgelegt ist, gibt XLATEOBJ_cGetPalette ebenfalls null zurück.

Hinweise

Der Treiber muss über Informationen zur Palette verfügen, um einige Methoden der Farbmischung ausführen zu können.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys

Weitere Informationen

XLATEOBJ

Freigeben über