Metodo IDirect3DDevice9::GetBackBuffer (d3d9helper.h)
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 |