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 |