Fonction D3DXCreateTexture
Crée une texture vide, en ajustant les paramètres appelants 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 [in]
-
Type : LPDIRECT3DDEVICE9
Pointeur vers une interface IDirect3DDevice9 , représentant l’appareil à associer à la texture.
-
Largeur [in]
-
Type : UINT
Largeur en pixels. Si cette valeur est 0, une valeur de 1 est utilisée. Consultez la section Notes.
-
Hauteur [in]
-
Type : UINT
Hauteur en pixels. Si cette valeur est 0, une valeur de 1 est utilisée. Consultez la section Notes.
-
MipLevels [in]
-
Type : UINT
Nombre de niveaux de mip demandés. Si cette valeur est égale à zéro ou D3DX_DEFAULT, une chaîne mipmap complète est créée.
-
Utilisation [in]
-
Type : DWORD
0, D3DUSAGE_RENDERTARGET ou D3DUSAGE_DYNAMIC. La définition de cet indicateur sur D3DUSAGE_RENDERTARGET 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 case activée que l’appareil prend en charge cette opération en appelant CheckDeviceFormat. Pour plus d’informations sur l’utilisation de textures dynamiques, consultez Utilisation de textures dynamiques.
-
Format [in]
-
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 case activée le format de la texture retournée pour voir si elle correspond au format demandé.
-
Pool [in]
-
Type : D3DPOOL
Membre du type énuméré D3DPOOL , décrivant la classe de mémoire dans laquelle la texture doit être placée.
-
ppTexture [out]
-
Type : LPDIRECT3DTEXTURE9*
Adresse d’un pointeur vers une interface IDirect3DTexture9 , représentant l’objet de texture créé.
Valeur retournée
Type : HRESULT
Si la fonction réussit, 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 appelants. Par conséquent, les appels à D3DXCreateTexture réussissent souvent là où 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 est carrée avec la hauteur et la largeur égales à la valeur numérique.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi