IDirect3DDevice9::GetBackBuffer-Methode (d3d9helper.h)

Artikel
08/23/2023

Ruft einen Rückpuffer aus der Swapchain des Geräts ab.

Syntax

HRESULT GetBackBuffer(
  [in]          UINT               iSwapChain,
  [in]          UINT               iBackBuffer,
  [in]          D3DBACKBUFFER_TYPE Type,
  [out, retval] IDirect3DSurface9  **ppBackBuffer
);

Parameter

[in] iSwapChain

Typ: UINT

Eine ganze Zahl ohne Vorzeichen, die die Swapchain angibt.

[in] iBackBuffer

Typ: UINT

Index des zurückzugebenden Pufferobjekts. Backpuffer werden von 0 bis zur Gesamtzahl der Backpuffer minus 1 nummeriert. Der Wert 0 gibt den ersten Backpuffer und nicht den Frontpuffer zurück. Auf den Frontpuffer kann mit dieser Methode nicht zugegriffen werden. Verwenden Sie IDirect3DDevice9::GetFrontBufferData , um eine Kopie des Frontpuffers abzurufen.

[in] Type

Typ: D3DBACKBUFFER_TYPE

Die Stereoansicht wird in Direct3D 9 nicht unterstützt, sodass der einzige gültige Wert für diesen Parameter D3DBACKBUFFER_TYPE_MONO ist.

[out, retval] ppBackBuffer

Typ: IDirect3DSurface9**

Adresse eines Zeigers auf eine IDirect3DSurface9-Schnittstelle , die die zurückgegebene Zurückpufferoberfläche darstellt.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn BackBuffer die Gesamtzahl der Backpuffer gleicht oder überschreitet, 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	d3d9helper.h (einschließlich D3D9.h)
Bibliothek	D3D9.lib

Weitere Informationen

IDirect3DDevice9

IDirect3DDevice9::GetFrontBufferData