IDirect3DDevice9::GetRenderTarget-Methode (d3d9helper.h)

  • Artikel

Ruft eine Renderzieloberfläche ab.

Syntax

HRESULT GetRenderTarget(
  [in]  DWORD             RenderTargetIndex,
  [out] IDirect3DSurface9 **ppRenderTarget
);

Parameter

[in] RenderTargetIndex

Typ: DWORD

Index des Renderziels. Siehe Hinweise.

[out] ppRenderTarget

Typ: IDirect3DSurface9**

Adresse eines Zeigers auf eine IDirect3DSurface9-Schnittstelle , die die zurückgegebene Renderzieloberfläche für dieses Gerät 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 D3DERR_INVALIDCALL werden, wenn eines der Argumente ungültig ist, oder D3DERR_NOTFOUND, wenn für den angegebenen Index kein Renderziel verfügbar ist.

Hinweise

Methoden, die den Zustand zurückgeben, funktionieren in der Regel nicht auf einem Gerät, das mit D3DCREATE_PUREDEVICE erstellt wird. Diese Methode funktioniert jedoch auch auf einem reinen Gerät, da sie eine Schnittstelle zurückgibt.

Das Gerät kann jetzt mehrere Renderziele unterstützen. Die Anzahl der von einem Gerät unterstützten Renderziele ist im NumSimultaneousRTs-Member von D3DCAPS9 enthalten. Weitere Informationen finden Sie unter Mehrere Renderziele (Direct3D 9).

Wenn Sie diese Methode aufrufen, wird die interne Verweisanzahl auf der IDirect3DSurface9-Schnittstelle erhöht. Wenn IUnknown::Release nicht aufgerufen wird, wenn die Verwendung der IDirect3DSurface9-Schnittstelle abgeschlossen ist, kommt es zu einem Speicherverlust.

Anforderungen

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

Weitere Informationen

IDirect3DDevice9

IDirect3DDevice9::SetRenderTarget