IDirect3DSwapChain9::GetFrontBufferData-Methode (d3d9helper.h)
Generiert eine Kopie des Frontpuffers der Swapchain und platziert diese Kopie in einem von der Anwendung bereitgestellten Systemspeicherpuffer.
Syntax
HRESULT GetFrontBufferData(
[in, out] IDirect3DSurface9 *pDestSurface
);
Parameter
[in, out] pDestSurface
Typ: IDirect3DSurface9*
Zeiger auf eine IDirect3DSurface9-Schnittstelle , die eine Kopie des Frontpuffers der Swapchain empfängt. Die Daten werden in aufeinanderfolgenden Zeilen ohne dazwischen liegendes Leerzeichen zurückgegeben, beginnend von der vertikal höchsten Zeile bis zur niedrigsten. Im Fenstermodus sollte die Größe der Zieloberfläche die Größe des Desktops sein. Im Vollbildmodus sollte die Größe der Zieloberfläche die Bildschirmgröße aufweisen.
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn BackBuffer die Gesamtzahl der Backpuffer überschreitet oder gleich ist, schlägt die Funktion fehl und gibt D3DERR_INVALIDCALL zurück.
Hinweise
Wenn Sie diese Methode aufrufen, wird die interne Verweisanzahl auf der IDirect3DSurface9-Schnittstelle erhöht. Wenn IUnknown::Release nicht aufgerufen wird, wenn die Verwendung dieser IDirect3DSurface9-Schnittstelle abgeschlossen ist, kommt es zu einem Speicherverlust.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9helper.h (include D3D9.h) |
| Bibliothek | D3D9.lib |