Partager via


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

Génère une copie de la mémoire tampon frontale 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 frontale 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 arrière, la fonction échoue et retourne D3DERR_INVALIDCALL.

Notes

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.

Spécifications

   
Plateforme cible Windows
En-tête d3d9.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DSwapChain9