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 |