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

  • Article

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 d3d9helper.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DSwapChain9

IDirect3DSwapChain9 ::GetFrontBufferData