Partager via


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

Voir aussi

IDirect3DDevice9