Méthode IDirect3DSwapChain9 ::GetBackBuffer (d3d9.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 iBackBuffer,
[in] D3DBACKBUFFER_TYPE Type,
[out, retval] IDirect3DSurface9 **ppBackBuffer
);
Paramètres
[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 -1. 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 IDirect3DSwapChain9 ::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 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. Vous devez libérer toutes les surfaces obtenues via cette méthode avant de libérer la chaîne d’échange à laquelle elle appartient.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | d3d9.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |