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 Palettenaktualisierungsvorgang beschreibt.
unnamedParam3
pPaletteData- [in]
Ein Array von PALETTEENTRY-Strukturen, die aktualisiert werden sollen. 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.
Bemerkungen
Die Palettendaten im Array, das durch pPaletteData- angegeben wird, besteht aus einem UINT-Wert für jeden Paletteneintrag (PALETTEENTRY-Struktur). Der Paletteneintrag ist im ARGB-Format mit 8 Bit für jeden der vier Kanäle vorhanden.
Der Anzeigetreiber für den Benutzermodus verwendet die folgenden Elemente der D3DDDIARG_UPDATEPALETTE Struktur, auf die pData- verweist, um die Texturpalette zu aktualisieren:
- Das PaletteHandle Member gibt den Ziehpunkt für die Palette an, die der Oberfläche zugeordnet ist.
- Das StartIndex Member gibt den Index des Eintrags im Array bei pPaletteData- an, in dem das Update gestartet werden soll.
- Das NumEntries-Element gibt die Anzahl der Einträge im Array bei zu aktualisierenden pPaletteData- an.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |