IDirect3DSwapChain9::GetFrontBufferData-Methode (d3d9.h)
Generiert eine Kopie des Frontpuffers der Swapchain und platziert diese Kopie in einem Systemspeicherpuffer, der von der Anwendung bereitgestellt wird.
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 dazwischenliegendes Leerzeichen zurückgegeben, beginnend von der vertikal höchsten Zeile bis zur niedrigsten Zeile. 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 sein.
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
Durch Aufrufen dieser Methode wird die interne Verweisanzahl auf der IDirect3DSurface9-Schnittstelle erhöht. Fehler beim Aufrufen von IUnknown::Release , wenn die Verwendung dieser IDirect3DSurface9-Schnittstelle abgeschlossen ist, führt zu einem Speicherverlust.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | d3d9.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |