Méthode IDirectDrawPalette ::GetCaps (ddraw.h)
Récupère les fonctionnalités de l’objet palette.
Syntaxe
HRESULT GetCaps(
[out] LPDWORD unnamedParam1
);
Paramètres
[out] unnamedParam1
Pointeur vers une variable qui reçoit une valeur du membre dwPalCaps de la structure DDCAPS qui définit les fonctionnalités de palette. Cette valeur se compose d’un ou plusieurs des indicateurs suivants.
DDPCAPS_1BIT
L’index est 1 bit. Il existe deux entrées dans la table de couleurs.
DDPCAPS_2BIT
L’index est de 2 bits. Il existe quatre entrées dans la table de couleurs.
DDPCAPS_4BIT
L’index est de 4 bits. La table de couleurs contient 16 entrées.
DDPCAPS_8BIT
L’index est de 8 bits. La table de couleurs contient 256 entrées.
DDPCAPS_8BITENTRIES
L’index fait référence à un index de couleur 8 bits. Cet indicateur est valide uniquement lorsqu’il est utilisé avec l’indicateur DDPCAPS_1BIT, DDPCAPS_2BIT ou DDPCAPS_4BIT, et lorsque la surface cible est de 8 bpp. Chaque entrée de couleur a une longueur d'1 octet et est un index de la palette 8 bpp d’une surface de destination.
DDPCAPS_ALPHA
Le membre peFlags de la structure PALETTEENTRY associée doit être interprété comme une seule valeur alpha 8 bits (en plus des membres peRed, peGreen et peBlue ). Une palette créée avec cet indicateur ne peut être attachée qu’à une texture : une surface créée avec l’indicateur de fonctionnalité DDSCAPS_TEXTURE.
DDPCAPS_ALLOW256
Cette palette peut avoir toutes les 256 entrées définies.
DDPCAPS_PRIMARYSURFACE
Cette palette est attachée à la surface primaire. La modification de la table de couleurs de cette palette affecte immédiatement l’affichage, sauf si DDPSETPAL_VSYNC est spécifié et pris en charge.
DDPCAPS_PRIMARYSURFACELEFT
Cette palette est celle attachée à la surface primaire de l’œil gauche. La modification de la table de couleurs de cette palette affecte immédiatement l’affichage à l’œil gauche, sauf si DDPSETPAL_VSYNC est spécifié et pris en charge.
DDPCAPS_VSYNC
Les modifications de cette palette peuvent être synchronisées avec la fréquence d’actualisation du moniteur.
Valeur retournée
Si la méthode réussit, la valeur de retour est DD_OK.
En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |