IDirect3DDevice9::GetRenderTargetData-Methode (d3d9helper.h)

  • Artikel

Kopiert die Renderzieldaten aus dem Gerätespeicher in den Systemspeicher.

Syntax

HRESULT GetRenderTargetData(
  [in] IDirect3DSurface9 *pRenderTarget,
  [in] IDirect3DSurface9 *pDestSurface
);

Parameter

[in] pRenderTarget

Typ: IDirect3DSurface9*

Zeiger auf ein IDirect3DSurface9-Objekt , das ein Renderziel darstellt.

[in] pDestSurface

Typ: IDirect3DSurface9*

Zeiger auf ein IDirect3DSurface9-Objekt , das eine Zieloberfläche darstellt.

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

Die Zieloberfläche muss entweder eine einfache Oberfläche außerhalb des Bildschirms oder eine Ebene einer Textur (Mipmap oder Würfeltextur) sein, die mit D3DPOOL_SYSTEMMEM erstellt wurde.

Die Quelloberfläche muss ein reguläres Renderziel oder eine Ebene einer Renderzieltextur (Mipmap oder Cubetextur) sein, die mit POOL_DEFAULT erstellt wurde.

Diese Methode schlägt fehl, wenn:

  • Das Renderziel ist multisampled.
  • Das Quellrenderungsziel hat eine andere Größe als die Zieloberfläche.
  • Die Formate des Quellrenderungsziels und der Zieloberfläche stimmen nicht überein.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d9helper.h (include D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3DDevice9