IDirectDrawPalette::GetCaps-Methode (ddraw.h)
Ruft die Funktionen des Palettenobjekts ab.
Syntax
HRESULT GetCaps(
[out] LPDWORD unnamedParam1
);
Parameter
[out] unnamedParam1
Ein Zeiger auf eine Variable, die einen Wert vom dwPalCaps-Member der DDCAPS-Struktur empfängt, die Palettenfunktionen definiert. 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
Der peFlags-Member der zugeordneten PALETTEENTRY-Struktur muss als einzelner 8-Bit-Alphawert interpretiert werden (zusätzlich zu den Elementen peRed, peGreen und peBlue ). 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_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.
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
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |