Metodo IDirect3DDevice9::GetBackBuffer (d3d9helper.h)

  • Articolo

Recupera un buffer nascosto 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 nascosto da restituire. I buffer back sono numerati da 0 al numero totale di buffer back meno uno. Il valore 0 restituisce il primo buffer nascosto, 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 nascosto restituita.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene 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 . Se non si chiama IUnknown::Release al termine dell'uso di questa interfaccia IDirect3DSurface9 , si verifica una perdita di memoria.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione d3d9helper.h (include D3D9.h)
Libreria D3D9.lib

Vedi anche

IDirect3DDevice9

IDirect3DDevice9::GetFrontBufferData