HT_Get8BPPFormatPalette-Funktion (winddi.h)

Artikel
03/09/2024

Die HT_Get8BPPFormatPalette-Funktion gibt eine Halbtonpalette für die Verwendung auf standardmäßigen 8-Bit-Gerätetypen pro Pixel zurück.

Syntax

LONG HT_Get8BPPFormatPalette(
  [out] LPPALETTEENTRY pPaletteEntry,
  [in]  USHORT         RedGamma,
  [in]  USHORT         GreenGamma,
  [in]  USHORT         BlueGamma
);

Parameter

[out] pPaletteEntry

Zeiger auf ein Array von PALETTEENTRY-Strukturen (in der Microsoft Windows SDK-Dokumentation beschrieben). Wenn dieser Zeiger nicht NULL ist, geht GDI davon aus, dass er auf gültigen Speicherplatz verweist, in dem GDI die gesamte Halbtonpalette von 8 Bit pro Pixel platzieren kann.

[in] RedGamma

Gibt den roten, grünen und blauen Gammawert an. Dieser USHORT-Wert wird als reelle Zahl interpretiert, deren vier Ziffern mit der geringsten Bedeutung rechts neben dem (implizierten) Dezimalpunkt liegen. Beispielsweise stellt ein Gammawert von 10000 die reelle Zahl 1,0000 und 12345 1,2345 dar. Der minimale zulässige Gammawert ist 0,0000, und der maximal zulässige Wert ist 6,5535.

[in] GreenGamma

[in] BlueGamma

Rückgabewert

Wenn pPaletteEntry nicht NULL ist, ist der Rückgabewert die Anzahl der PALETTEENTRY-Strukturen, die GDI ab dem Speicherspeicherort ausgefüllt hat, auf den pPaletteEntry verweist. Wenn pPaletteEntryNULL ist, ist der Rückgabewert die Gesamtanzahl von PALETTEENTRY-Strukturen, die zum Speichern der Halbtonpalette von 8 Bits pro Pixel erforderlich sind.

Hinweise

HT_Get8BPPFormatPalette ist ein halbtonbezogener GDI-Dienst, mit dem Treiber die standardmäßige 8-Bit-Halbtonpalette des Systems abrufen 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

Freigeben über