Auf Englisch lesen

Freigeben über


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

Weitere Informationen

IDirect3DSwapChain9