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