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

Voir aussi

IDirect3DDevice9

IDirect3DDevice9::GetFrontBufferData