Méthode IDirect3DDevice9::GetBackBuffer (d3d9helper.h)
Récupère une mémoire tampon d’arrière-mémoire à partir de la chaîne d’échange de l’appareil.
Syntaxe
HRESULT GetBackBuffer(
[in] UINT iSwapChain,
[in] UINT iBackBuffer,
[in] D3DBACKBUFFER_TYPE Type,
[out, retval] IDirect3DSurface9 **ppBackBuffer
);
Paramètres
[in] iSwapChain
Type : UINT
Entier non signé spécifiant la chaîne d’échange.
[in] iBackBuffer
Type : UINT
Index de l’objet de mémoire tampon d’arrière-mémoire à retourner. Les mémoires tampons d’arrière-mémoire sont numérotées de 0 au nombre total de mémoires tampons d’arrière-mémoires moins un. La valeur 0 renvoie la première mémoire tampon d’arrière-plan, et non la mémoire tampon avant. La mémoire tampon avant n’est pas accessible via cette méthode. Utilisez IDirect3DDevice9::GetFrontBufferData pour récupérer une copie de la mémoire tampon avant.
[in] Type
Type : D3DBACKBUFFER_TYPE
La vue stéréo n’étant pas prise en charge dans Direct3D 9, la seule valeur valide pour ce paramètre est D3DBACKBUFFER_TYPE_MONO.
[out, retval] ppBackBuffer
Type : IDirect3DSurface9**
Adresse d’un pointeur vers une interface IDirect3DSurface9 , représentant la surface de mémoire tampon retournée.
Valeur retournée
Type : HRESULT
Si la méthode réussit, la valeur de retour est D3D_OK. Si BackBuffer est égal ou supérieur au nombre total de mémoires tampons d’arrière-mémoire, 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 | d3d9helper.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |