IDirect3DSwapChain9::GetFrontBufferData-Methode (d3d9helper.h)

  • Artikel

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

Weitere Informationen

IDirect3DSwapChain9