IDirect3DDevice9::GetFrontBufferData-Methode (d3d9.h)
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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |