PFND3DDDI_UPDATEPALETTE Rückruffunktion (d3dumddi.h)

  • Artikel

Die UpdatePalette-Funktion aktualisiert eine Texturpalette.

Syntax

PFND3DDDI_UPDATEPALETTE Pfnd3dddiUpdatepalette;

HRESULT Pfnd3dddiUpdatepalette(
  [in] HANDLE hDevice,
       const D3DDDIARG_UPDATEPALETTE *unnamedParam2,
       const PALETTEENTRY *unnamedParam3
)
{...}

Parameter

[in] hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

pData [in]

Ein Zeiger auf eine D3DDDIARG_UPDATEPALETTE Struktur, die Parameter für den Vorgang zum Aktualisieren der Palette beschreibt.

unnamedParam3

pPaletteData [in]

Ein Array von zu aktualisierenden PALETTEENTRY-Strukturen. Weitere Informationen zu PALETTEENTRY finden Sie in der Microsoft Windows SDK-Dokumentation.

Rückgabewert

UpdatePalette gibt S_OK oder ein entsprechendes Fehlerergebnis zurück, wenn die Texturpalette nicht erfolgreich aktualisiert wurde.

Hinweise

Die Palettendaten in dem Array, das von pPaletteData angegeben wird, bestehen aus einem UINT-Wert für jeden Paletteneintrag (PALETTEENTRY-Struktur). Der Paletteneintrag ist im ARGB-Format mit 8 Bits für jeden der vier Kanäle.

Der Benutzermodusanzeigetreiber verwendet die folgenden Elemente der D3DDDIARG_UPDATEPALETTE-Struktur , auf die pData verweist, um die Texturpalette zu aktualisieren:

  • Das PaletteHandle-Element gibt den Handle der Palette an, die der Oberfläche zugeordnet ist.
  • Das StartIndex-Element gibt den Index des Eintrags im Array bei pPaletteData an, an dem das Update beginnen soll.
  • Das NumEntries-Element gibt die Anzahl der zu aktualisierenden Einträge im Array bei pPaletteData an.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile d3dumddi.h (include D3dumddi.h)

Weitere Informationen

D3DDDIARG_UPDATEPALETTE

D3DDDI_DEVICEFUNCS