IDirectDraw7::CreatePalette-Methode (ddraw.h)
Erstellt ein DirectDrawPalette-Objekt für dieses DirectDraw-Objekt.
Syntax
HRESULT CreatePalette(
[in] DWORD unnamedParam1,
[in] LPPALETTEENTRY unnamedParam2,
[out] LPDIRECTDRAWPALETTE *unnamedParam3,
[in] IUnknown *unnamedParam4
);
Parameter
[in] unnamedParam1
Dieser Wert besteht aus mindestens einem der folgenden Flags:
DDPCAPS_1BIT
Der Index ist 1 Bit. Die Farbtabelle enthält zwei Einträge.
DDPCAPS_2BIT
Der Index ist 2 Bits. Die Farbtabelle enthält vier Einträge.
DDPCAPS_4BIT
Der Index ist 4 Bits. Die Farbtabelle enthält 16 Einträge.
DDPCAPS_8BIT
Der Index ist 8 Bits. Die Farbtabelle enthält 256 Einträge.
DDPCAPS_8BITENTRIES
Der Index bezieht sich auf einen 8-Bit-Farbindex. Dieses Flag ist nur gültig, wenn es mit dem flag DDPCAPS_1BIT, DDPCAPS_2BIT oder DDPCAPS_4BIT verwendet wird und wenn die Zieloberfläche 8 bpp beträgt. Jeder Farbeintrag ist 1 Byte lang und ist ein Index für die 8-bpp-Palette einer Zieloberfläche.
DDPCAPS_ALPHA
Das peFlags-Element der zugeordneten PALETTEENTRY-Struktur ist als einzelner 8-Bit-Alphawert zu interpretieren (zusätzlich zu den PeRed-, peGreen- und peBlue-Membern ). Eine mit diesem Flag erstellte Palette kann nur an eine Textur angefügt werden: eine Oberfläche, die mit dem DDSCAPS_TEXTURE-Funktionsflag erstellt wurde.
DDPCAPS_ALLOW256
Für diese Palette können alle 256 Einträge definiert sein.
DDPCAPS_INITIALIZE
Veraltet. DirectDraw initialisiert diese Palette immer mit den Farben im Farbarray, das an lpDDColorArray übergeben wird.
DDPCAPS_PRIMARYSURFACE
Diese Palette ist an die primäre Oberfläche angefügt. Das Ändern der Farbtabelle dieser Palette wirkt sich sofort auf die Anzeige aus, es sei denn, DDPSETPAL_VSYNC angegeben und unterstützt wird.
DDPCAPS_PRIMARYSURFACELEFT
Diese Palette ist an der primären Oberfläche des linken Auges angebracht. Das Ändern der Farbtabelle dieser Palette wirkt sich sofort auf die Anzeige auf dem linken Auge aus, es sei denn, DDPSETPAL_VSYNC angegeben und unterstützt wird.
DDPCAPS_VSYNC
Diese Palette kann Änderungen an ihr aufweisen, die mit der Aktualisierungsrate des Monitors synchronisiert werden.
[in] unnamedParam2
Adresse eines Arrays mit 2, 4, 16 oder 256 PALETTEENTRY-Strukturen zum Initialisieren des DirectDrawPalette-Objekts.
[out] unnamedParam3
Adresse einer Variablen, die auf einen gültigen IDirectDrawPalette-Schnittstellenzeiger festgelegt werden soll, wenn der Aufruf erfolgreich ist.
[in] unnamedParam4
Ermöglicht zukünftige Kompatibilität mit COM-Aggregationsfeatures. Derzeit gibt diese Methode einen Fehler zurück, wenn dieser Parameter nicht NULL ist.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.
Wenn ein Fehler auftritt, kann die -Methode einen der folgenden Fehlerwerte zurückgeben:
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOCOOPERATIVELEVELSET
- DDERR_OUTOFMEMORY
- DDERR_UNSUPPORTED
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |