Méthode IDirectDrawSurface7 ::AddAttachedSurface (ddraw.h)
Attache la surface de mémoire tampon z spécifiée à cette surface.
Syntaxe
HRESULT AddAttachedSurface(
[in] LPDIRECTDRAWSURFACE7 unnamedParam1
);
Paramètres
[in] unnamedParam1
Adresse de l’interface IDirectDrawSurface7 pour la surface à attacher.
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_CANNOTATTACHSURFACE
- DDERR_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_SURFACEALREADYATTACHED
- DDERR_SURFACELOST
- DDERR_WASSTILLDRAWING
Remarques
AddAttachedSurface incrémente le nombre de références de la surface attachée. Vous pouvez détacher explicitement la surface et décrémenter son nombre de références à l’aide de la méthode IDirectDrawSurface7 ::D eleteAttachedSurface . Contrairement aux surfaces complexes que vous créez avec un seul appel à IDirectDraw7 ::CreateSurface, les surfaces attachées à cette méthode ne sont pas automatiquement libérées. L’application doit libérer ces surfaces.
Vous pouvez attacher uniquement des surfaces de mémoire tampon z avec cette méthode.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |