Méthode IDirect3DSwapChain9 ::GetFrontBufferData (d3d9helper.h)

Génère une copie de la mémoire tampon avant de la chaîne d’échange et place cette copie dans une mémoire tampon système fournie par l’application.

Syntaxe

HRESULT GetFrontBufferData(
  [in, out] IDirect3DSurface9 *pDestSurface
);

Paramètres

[in, out] pDestSurface

Type : IDirect3DSurface9*

Pointeur vers une interface IDirect3DSurface9 qui recevra une copie de la mémoire tampon avant de la chaîne d’échange. Les données sont retournées dans des lignes successives sans espace intermédiaire, en commençant de la ligne verticalement la plus élevée à la ligne la plus basse. Pour le mode fenêtré, la taille de la surface de destination doit être la taille du bureau. Pour le mode plein écran, la taille de la surface de destination doit être la taille de l’écran.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si BackBuffer dépasse ou est égal au nombre total de mémoires tampons d’arrière-mémoire, la fonction échoue et retourne D3DERR_INVALIDCALL.

Remarques

L’appel de cette méthode augmente le nombre de références internes sur l’interface IDirect3DSurface9 . L’échec de l’appel de IUnknown ::Release lorsque vous avez terminé d’utiliser cette interface IDirect3DSurface9 entraîne une fuite de mémoire.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	d3d9helper.h (inclure D3D9.h)
Bibliothèque	D3D9.lib

Voir aussi

IDirect3DSwapChain9