Metodo IDirect3DDevice9::GetBackBuffer (d3d9.h)

Articolo
08/23/2023

Recupera un buffer indietro dalla catena di scambio del dispositivo.

Sintassi

HRESULT GetBackBuffer(
  [in]          UINT               iSwapChain,
  [in]          UINT               iBackBuffer,
  [in]          D3DBACKBUFFER_TYPE Type,
  [out, retval] IDirect3DSurface9  **ppBackBuffer
);

Parametri

[in] iSwapChain

Tipo: UINT

Intero senza segno che specifica la catena di scambio.

[in] iBackBuffer

Tipo: UINT

Indice dell'oggetto buffer back da restituire. I buffer back vengono numerati da 0 al numero totale di buffer indietro meno uno. Un valore pari a 0 restituisce il primo buffer indietro, non il buffer anteriore. Il buffer anteriore non è accessibile tramite questo metodo. Usare IDirect3DDevice9::GetFrontBufferData per recuperare una copia del buffer anteriore.

[in] Type

Tipo: D3DBACKBUFFER_TYPE

La visualizzazione stereo non è supportata in Direct3D 9, quindi l'unico valore valido per questo parametro è D3DBACKBUFFER_TYPE_MONO.

[out, retval] ppBackBuffer

Tipo: IDirect3DSurface9**

Indirizzo di un puntatore a un'interfaccia IDirect3DSurface9 che rappresenta la superficie del buffer back restituito.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se BackBuffer è uguale o supera il numero totale di buffer back, la funzione ha esito negativo e restituisce D3DERR_INVALIDCALL.

Commenti

La chiamata a questo metodo aumenterà il conteggio dei riferimenti interni nell'interfaccia IDirect3DSurface9 . L'errore di chiamare IUnknown::Release al termine dell'uso di questa interfaccia IDirect3DSurface9 genera una perdita di memoria.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	d3d9.h (includere D3D9.h)
Libreria	D3D9.lib

Vedi anche

IDirect3DDevice9

IDirect3DDevice9::GetFrontBufferData

Condividi tramite