Partager via


Méthode IDirect3DDevice9 ::GetRenderTarget (d3d9.h)

Récupère une surface cible de rendu.

Syntaxe

HRESULT GetRenderTarget(
  [in]  DWORD             RenderTargetIndex,
  [out] IDirect3DSurface9 **ppRenderTarget
);

Paramètres

[in] RenderTargetIndex

Type : DWORD

Index de la cible de rendu. Consultez la section Notes.

[out] ppRenderTarget

Type : IDirect3DSurface9**

Adresse d’un pointeur vers une interface IDirect3DSurface9 , représentant la surface cible de rendu retournée pour cet appareil.

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 D3DERR_INVALIDCALL si l’un des arguments n’est pas valide ou D3DERR_NOTFOUND si aucune cible de rendu n’est disponible pour l’index donné.

Remarques

En règle générale, les méthodes qui retournent l’état ne fonctionnent pas sur un appareil créé à l’aide de D3DCREATE_PUREDEVICE. Toutefois, cette méthode fonctionne même sur un appareil pur, car elle retourne une interface.

L’appareil peut désormais prendre en charge plusieurs cibles de rendu. Le nombre de cibles de rendu prises en charge par un appareil est contenu dans le membre NumSimultaneousRTs de D3DCAPS9. Consultez Cibles de rendu multiples (Direct3D 9).

L’appel de cette méthode augmente le nombre de références internes sur l’interface IDirect3DSurface9 . L’échec de l’appel de IUnknown ::Release lorsque vous avez terminé d’utiliser l’interface IDirect3DSurface9 entraîne une fuite de mémoire.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d9.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DDevice9

IDirect3DDevice9 ::SetRenderTarget