DrvSetPalette-Funktion (winddi.h)

Artikel
08/27/2023

Die DrvSetPalette-Funktion fordert den Treiber auf, die Palette für ein angegebenes Gerät zu realisieren.

Syntax

BOOL DrvSetPalette(
  DHPDEV dhpdev,
  PALOBJ *ppalo,
  FLONG  fl,
  ULONG  iStart,
  ULONG  cColors
);

Parameter

dhpdev

Handle an die PDEV-Struktur des physischen Geräts, die das Gerät identifiziert, dessen Palette realisiert werden soll. Dieser Parameter ist das Gerätehandle, das von DrvEnablePDEV an GDI zurückgegeben wird.

ppalo

Zeiger auf die PALOBJ-Struktur , aus der die Farben (RGB-Werte) abgefragt werden sollen.

fl

Ein Satz von Flags, der Hinweise und Optionen bereitstellt. Dieser Parameter kann der folgende Wert sein:

Wert	Bedeutung
SP_DEFAULT	Die Palette ist die vollständige Standardpalette des Geräts. Die PALOBJ kann ignoriert werden, enthält aber den richtigen Inhalt.

iStart

Gibt den ersten zu überschreibenden Palettenindex an.

cColors

Gibt die Anzahl der Farben an, die in der Hardwarepalette geändert werden sollen. Zusätzliche Farben, die über die in der Hardware verfügbare Zahl hinausgehen, können ignoriert werden. Wenn cColors kleiner als die Größe der Hardwarepalette ist, legen Sie nur cColors-Einträge fest, und lassen Sie die verbleibenden Farben unverändert.

Rückgabewert

Der Rückgabewert ist TRUE , wenn die Funktion erfolgreich ist. Andernfalls ist es FALSE, und ein Fehlercode wird protokolliert.

Hinweise

Der Treiber legt die Hardwarepalette so fest, dass sie den Einträgen in der angegebenen Palette so nah wie möglich entspricht.

Nur indizierte Paletten sind realisierbar. Das RC_PALETTE Bit des flRasterCaps-Elements der GDIINFO-Struktur gibt an, ob ein Gerät über eine realisierbare Palette verfügt.

DrvSetPalette ist für Anzeigetreiber erforderlich, die realisierbare Paletten unterstützen.