D3DXCreateTexture fonction)

Crée une texture vide, en ajustant les paramètres d’appel en fonction des besoins.

Syntaxe

HRESULT D3DXCreateTexture(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  UINT               Width,
  _In_  UINT               Height,
  _In_  UINT               MipLevels,
  _In_  DWORD              Usage,
  _In_  D3DFORMAT          Format,
  _In_  D3DPOOL            Pool,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Paramètres

pDevice [ dans]

Type : LPDIRECT3DDEVICE9

Pointeur vers une interface IDirect3DDevice9 , représentant l’appareil à associer à la texture.

Largeur [ dans]

Type : uint

Largeur en pixels. Si cette valeur est égale à 0, la valeur 1 est utilisée. Consultez la section Notes.

Hauteur [ dans]

Type : uint

Hauteur en pixels. Si cette valeur est égale à 0, la valeur 1 est utilisée. Consultez la section Notes.

Miplevels a [ dans]

Type : uint

Nombre de niveaux MIP demandés. Si cette valeur est égale à zéro ou à D3DX _ default, une chaîne mipmap complète est créée.

Utilisation [ dans]

Type : DWORD

0, D3DUSAGE _ RENDERTARGETou D3DUSAGE _ dynamique. L’affectation de la valeur D3DUSAGE _ RENDERTARGET à cet indicateur indique que la surface doit être utilisée comme cible de rendu en appelant la méthode SetRenderTarget . Si D3DUSAGE _ RENDERTARGET ou D3DUSAGE _ Dynamic est spécifié, l’application doit vérifier que l’appareil prend en charge cette opération en appelant CheckDeviceFormat. Pour plus d’informations sur l’utilisation des textures dynamiques, consultez utilisation de textures dynamiques.

Format [ dans]

Type : D3DFORMAT

Membre du type énuméré D3DFORMAT , décrivant le format de pixel demandé pour la texture. La texture retournée peut être d’un format différent de celui spécifié, si l’appareil ne prend pas en charge le format demandé. Les applications doivent vérifier le format de la texture retournée pour voir si elle correspond au format demandé.

Pool [ dans]

Type : D3DPOOL

Membre du type énuméré D3DPOOL , décrivant la classe de mémoire dans laquelle la texture doit être placée.

ppTexture [ à]

Type : LPDIRECT3DTEXTURE9*

Adresse d’un pointeur vers une interface IDirect3DTexture9 représentant l’objet de texture créé.

Valeur de retour

Type : HRESULT

Si la fonction est réussie, la valeur de retour est D3D _ OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR _ INVALIDCALL, D3DERR _ NOTAVAILABLE, D3DERR _ OUTOFVIDEOMEMORY, E _ OUTOFMEMORY.

Notes

En interne, D3DXCreateTexture utilise D3DXCheckTextureRequirements pour ajuster les paramètres d’appel. Par conséquent, les appels à D3DXCreateTexture aboutissent souvent lorsque les appels à CreateTexture échouent.

Si la hauteur et la largeur sont définies sur D3DX _ default, la valeur 256 est utilisée pour les deux paramètres. Si la hauteur ou la largeur est définie sur D3DX _ Default et que l’autre paramètre est défini sur une valeur numérique, la texture sera carré avec la hauteur et la largeur égales à la valeur numérique.

Spécifications

Condition requise Valeur
En-tête
D3dx9tex. h
Bibliothèque
D3dx9. lib

Voir aussi

Fonctions de texture dans D3DX 9