Metodo IDirect3DDevice9::GetFrontBufferData (d3d9helper.h)

  • Articolo

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

Sintassi

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

Parametri

[in] iSwapChain

Tipo: UINT

Intero senza segno che specifica la catena di scambio.

[in] pDestSurface

Tipo: IDirect3DSurface9*

Puntatore a un'interfaccia IDirect3DSurface9 che riceverà una copia del contenuto del buffer anteriore. I dati vengono restituiti in righe successive senza spazio di intervento, a partire dalla riga verticalmente più alta dell'output del dispositivo 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 il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST, D3DERR_INVALIDCALL

Commenti

Il buffer a cui fa riferimento pDestSurface verrà riempito con una rappresentazione del buffer anteriore, convertito in 32 bit standard per formato pixel D3DFMT_A8R8G8B8.

Questo metodo è l'unico modo per acquisire una schermata antialiased.

Questa funzione è molto lenta, per progettazione e non deve essere usata in alcun percorso critico per le prestazioni.

Per altre informazioni, vedere Dispositivi persi e dati recuperati.

Requisiti

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

Vedi anche

IDirect3DDevice9