IDirect3DDevice9::GetRenderTarget-Methode (d3d9helper.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).
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 |