IDirect3DDevice9::GetFrontBufferData-Methode (d3d9helper.h)

  • Artikel

Generiert eine Kopie des Frontpuffers des Geräts und stellt die Kopie in einem Systemspeicherpuffer, der von der Anwendung bereitgestellt wird.

Syntax

HRESULT GetFrontBufferData(
  [in] UINT              iSwapChain,
  [in] IDirect3DSurface9 *pDestSurface
);

Parameter

[in] iSwapChain

Typ: UINT

Eine ganze Zahl ohne Vorzeichen, die die Swapchain angibt.

[in] pDestSurface

Typ: IDirect3DSurface9*

Zeiger auf eine IDirect3DSurface9-Schnittstelle , die eine Kopie des Inhalts des Frontpuffers empfängt. Die Daten werden in aufeinanderfolgenden Zeilen ohne Zwischenspeicher zurückgegeben, beginnend von der vertikal höchsten Zeile auf der Ausgabe des Geräts 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 sein.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST, D3DERR_INVALIDCALL

Hinweise

Der Puffer, auf den pDestSurface verweist, wird mit einer Darstellung des Frontpuffers gefüllt, die in das Standardformat von 32 Bit pro Pixel D3DFMT_A8R8G8B8 konvertiert wird.

Diese Methode ist die einzige Möglichkeit, einen Antialiased-Screenshot zu erfassen.

Diese Funktion ist vom Entwurf her sehr langsam und sollte in keinem leistungskritischen Pfad verwendet werden.

Weitere Informationen finden Sie unter Verlorene Geräte und abgerufene Daten.

Anforderungen

   
Zielplattform Windows
Kopfzeile d3d9helper.h (einschließlich D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3DDevice9