Méthode IDirectDrawSurface7 ::SetPalette (ddraw.h)
Attache un objet de palette à une surface (ou en détache un. La surface utilise cette palette pour toutes les opérations suivantes. Le changement de palette a lieu immédiatement, sans tenir compte du moment d’actualisation.
Syntaxe
HRESULT SetPalette(
[in] LPDIRECTDRAWPALETTE unnamedParam1
);
Paramètres
[in] unnamedParam1
Pointeur vers l’interface IDirectDrawPalette pour l’objet palette à utiliser avec cette surface. Si la valeur est NULL, la palette actuelle est détachée.
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_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDPIXELFORMAT
- DDERR_INVALIDSURFACETYPE
- DDERR_NOEXCLUSIVEMODE
- DDERR_NOPALETTEATTACHED
- DDERR_NOPALETTEHW
- DDERR_NOT8BITCOLOR
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
Remarques
Lorsque vous appelez SetPalette pour définir une palette sur une surface pour la première fois, SetPalette incrémente le nombre de références de la palette ; Les appels suivants à SetPalette n’affectent pas le nombre de références de la palette. Si vous passez NULL comme paramètre lpDDPalette , la palette est supprimée de la surface et le nombre de références de la palette est décrémenté. Si vous ne supprimez pas la palette, la surface libère automatiquement sa référence à la palette lorsque la surface elle-même est libérée. Selon les règles COM, votre application doit libérer toutes les références qu’elle contient à la palette lorsque l’objet n’est plus nécessaire.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |