Fonction D3DXCreateVolumeTexture
Crée une texture de volume vide, en ajustant les paramètres appelants en fonction des besoins.
Syntaxe
HRESULT D3DXCreateVolumeTexture(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ UINT Width,
_In_ UINT Height,
_In_ UINT Depth,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);
Paramètres
-
pDevice [in]
-
Type : LPDIRECT3DDEVICE9
Pointeur vers une interface IDirect3DDevice9 , représentant l’appareil à associer à la texture du volume.
-
Largeur [in]
-
Type : UINT
Largeur en pixels. Cette valeur doit être différente de zéro. La dimension maximale prise en charge par un pilote (pour la largeur, la hauteur et la profondeur) se trouve dans MaxVolumeExtent dans D3DCAPS9.
-
Hauteur [in]
-
Type : UINT
Hauteur en pixels. Cette valeur doit être différente de zéro. La dimension maximale prise en charge par un pilote (pour la largeur, la hauteur et la profondeur) se trouve dans MaxVolumeExtent dans D3DCAPS9.
-
Profondeur [in]
-
Type : UINT
Profondeur en pixels. Cette valeur doit être différente de zéro. La dimension maximale prise en charge par un pilote (pour la largeur, la hauteur et la profondeur) se trouve dans MaxVolumeExtent dans D3DCAPS9.
-
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 ou D3DUSAGE_DYNAMIC. 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 du volume. La texture de volume retournée peut avoir un format différent de celui spécifié par Format. Les applications doivent case activée le format de la texture de volume retournée.
-
Pool [in]
-
Type : D3DPOOL
Membre du type énuméré D3DPOOL , décrivant la classe de mémoire dans laquelle la texture de volume doit être placée.
-
ppVolumeTexture [out]
-
Type : LPDIRECT3DVOLUMETEXTURE9*
Adresse d’un pointeur vers une interface IDirect3DVolumeTexture9 , représentant l’objet de texture de volume 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_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, E_OUTOFMEMORY .
Notes
En interne, D3DXCreateVolumeTexture utilise D3DXCheckVolumeTextureRequirements pour ajuster les paramètres appelants. Par conséquent, les appels à D3DXCreateVolumeTexture réussissent souvent là où les appels à CreateVolumeTexture échouent.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi