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 |