Partager via


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

Récupère une texture affectée à une étape pour un appareil.

Syntaxe

HRESULT GetTexture(
  [in]          DWORD                 Stage,
  [out, retval] IDirect3DBaseTexture9 **ppTexture
);

Paramètres

[in] Stage

Type : DWORD

Identificateur d’étape de la texture à récupérer. Les identificateurs d’étape sont de base zéro.

[out, retval] ppTexture

Type : IDirect3DBaseTexture9**

Adresse d’un pointeur vers une interface IDirect3DBaseTexture9 , représentant la texture retournée.

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.

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’appel de cette méthode augmente le nombre de références internes sur l’interface IDirect3DTexture9 . L’échec de l’appel de IUnknown ::Release lorsque vous avez terminé d’utiliser cette interface IDirect3DTexture9 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 ::GetTextureStageState

IDirect3DDevice9 ::SetTexture

IDirect3DDevice9 ::SetTextureStageState