Méthode IDirectDrawSurface7::D eleteAttachedSurface (ddraw.h)
Détache une ou plusieurs surfaces attachées.
Syntaxe
HRESULT DeleteAttachedSurface(
[in] DWORD unnamedParam1,
[in] LPDIRECTDRAWSURFACE7 unnamedParam2
);
Paramètres
[in] unnamedParam1
Actuellement non utilisé et doit être défini sur 0.
[in] unnamedParam2
Pointeur vers l’interface IDirectDrawSurface7 pour détacher l’objet DirectDrawSurface. Si ce paramètre a la valeur NULL, toutes les surfaces attachées sont détachées.
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_CANNOTDETACHSURFACE
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_SURFACELOST
- DDERR_SURFACENOTATTACHED
Notes
DeleteAttachedSurface décrémente le nombre de références de la surface à détacher. Si le nombre de références de la surface à détacher atteint 0, la surface est perdue et supprimée de la mémoire.
Les pièces jointes implicites, celles formées par DirectDraw plutôt que par la méthode IDirectDrawSurface7::AddAttachedSurface , ne peuvent pas être détachées. Le détachement de surfaces d’une chaîne de basculement peut modifier d’autres surfaces dans la chaîne. Si une mémoire tampon avant est détachée d’une chaîne de basculement, la surface suivante de la chaîne devient la mémoire tampon avant et la surface suivante devient la mémoire tampon arrière. Si une mémoire tampon arrière est détachée d’une chaîne, la surface suivante devient une mémoire tampon arrière. Si une surface simple est détachée d’une chaîne, la chaîne devient simplement plus courte. Si une chaîne de basculement n’a que deux surfaces et qu’elles sont détachées, la chaîne est détruite et les deux surfaces reviennent à leurs désignations précédentes.
Spécifications
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |