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
| 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 |