Metodo IDirect3DSwapChain9::GetFrontBufferData (d3d9helper.h)

Genera una copia del buffer anteriore della swapchain e inserisce la copia in un buffer di memoria di sistema fornito dall'applicazione.

Sintassi

HRESULT GetFrontBufferData(
  [in, out] IDirect3DSurface9 *pDestSurface
);

Parametri

[in, out] pDestSurface

Tipo: IDirect3DSurface9*

Puntatore a un'interfaccia IDirect3DSurface9 che riceverà una copia del buffer anteriore della swapchain. I dati vengono restituiti in righe successive senza spazio di intervento, a partire dalla riga verticalmente più alta al minimo. Per la modalità finestra, le dimensioni dell'area di destinazione devono essere le dimensioni del desktop. Per la modalità schermo intero, le dimensioni dell'area di destinazione devono essere le dimensioni dello schermo.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è 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 . L'errore di chiamare IUnknown::Release al termine dell'uso di questa interfaccia IDirect3DSurface9 genera una perdita di memoria.

Requisiti

Vedi anche

IDirect3DSwapChain9