PFND3DDDI_UPDATEPALETTE Rückruffunktion (d3dumddi.h)
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) |