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

Article
03/09/2024

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.