IDirect3DSwapChain9::GetBackBuffer-Methode (d3d9helper.h)
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 |