Méthode IDirect3DDevice9::GetBackBuffer (d3d9.h)

Article
08/23/2023

Récupère une mémoire tampon arrière à 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 arrière à retourner. Les mémoires tampons back-back sont numérotées de 0 au nombre total de mémoires tampons back-back moins un. La valeur 0 retourne la première mémoire tampon arrière, et non la mémoire tampon avant. La mémoire tampon frontale n’est pas accessible via cette méthode. Utilisez IDirect3DDevice9::GetFrontBufferData pour récupérer une copie de la mémoire tampon frontale.

[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 arrière 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 arrière, 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	d3d9.h (inclure D3D9.h)
Bibliothèque	D3D9.lib

Voir aussi

IDirect3DDevice9

IDirect3DDevice9::GetFrontBufferData

Partager via