Méthode IDirectDrawSurface7::D eleteAttachedSurface (ddraw.h)

  • Article

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

Voir aussi

IDirectDrawSurface7