IDirect3DSwapChain9::GetBackBuffer-Methode (d3d9helper.h)

  • Artikel

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

Syntax

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

Parameter

[in] iBackBuffer

Typ: UINT

Index des zurückzugebenden Pufferobjekts. Backpuffer werden von 0 bis zur Gesamtzahl der Backpuffer nummeriert : 1. 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 IDirect3DSwapChain9::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 ü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. Sie müssen alle Oberflächen freigeben, die mit dieser Methode abgerufen wurden, bevor Sie die Swapchain freigeben, zu der sie gehört.

Anforderungen

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

Weitere Informationen

IDirect3DSwapChain9

IDirect3DSwapChain9::GetFrontBufferData