IDirect3DDevice9::GetRenderTarget-Methode (d3d9.h)
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).
Durch Aufrufen dieser Methode wird die interne Verweisanzahl auf der IDirect3DSurface9-Schnittstelle erhöht. Fehler beim Aufrufen von IUnknown::Release nach Abschluss der Verwendung der IDirect3DSurface9-Schnittstelle führt zu einem Speicherverlust.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |