IDirect3DDevice9::GetRenderTargetData-Methode (d3d9.h)
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 off-Screen-Oberfläche oder eine Ebene einer Textur (Mipmap oder Cubetextur) 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 Quellrenderziel hat eine andere Größe als die Zieloberfläche.
- Die Quellrenderziel- und Zieloberflächenformate stimmen nicht überein.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |