Metodo IDirect3DSwapChain9::GetBackBuffer (d3d9helper.h)

Recupera un buffer nascosto dalla catena di scambio del dispositivo.

Sintassi

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

Parametri

[in] iBackBuffer

Tipo: UINT

Indice dell'oggetto buffer nascosto da restituire. I buffer back vengono numerati da 0 al numero totale di buffer back - 1. Il valore 0 restituisce il primo buffer nascosto, non il buffer anteriore. Il buffer anteriore non è accessibile tramite questo metodo. Usare IDirect3DSwapChain9::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 supera o equivale al 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. È necessario rilasciare tutte le superfici ottenute tramite questo metodo prima di rilasciare la catena di scambio a cui appartiene.

Requisiti

Vedi anche

IDirect3DSwapChain9

IDirect3DSwapChain9::GetFrontBufferData