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