Méthode IDirect3DDevice9 ::GetRenderTargetData (d3d9.h)
Copie les données de la cible de rendu de la mémoire de l’appareil vers la mémoire système.
Syntaxe
HRESULT GetRenderTargetData(
[in] IDirect3DSurface9 *pRenderTarget,
[in] IDirect3DSurface9 *pDestSurface
);
Paramètres
[in] pRenderTarget
Type : IDirect3DSurface9*
Pointeur vers un objet IDirect3DSurface9 , représentant une cible de rendu.
[in] pDestSurface
Type : IDirect3DSurface9*
Pointeur vers un objet IDirect3DSurface9 , représentant une surface de destination.
Valeur retournée
Type : HRESULT
Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être l’une des valeurs suivantes : D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST, D3DERR_INVALIDCALL.
Remarques
La surface de destination doit être une surface simple hors écran ou un niveau de texture (texture mipmap ou cube) créée avec D3DPOOL_SYSTEMMEM.
La surface source doit être une cible de rendu régulière ou un niveau de texture de cible de rendu (texture mipmap ou cube) créée avec POOL_DEFAULT.
Cette méthode échoue si :
- La cible de rendu est échantillonnée à plusieurs échantillons.
- La cible de rendu source a une taille différente de la surface de destination.
- Les formats de la cible de rendu source et de la surface de destination ne correspondent pas.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | d3d9.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |