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

Article
08/23/2023

Crée une ressource de texture de volume.

Syntaxe

HRESULT CreateVolumeTexture(
  [in]          UINT                    Width,
  [in]          UINT                    Height,
  [in]          UINT                    Depth,
  [in]          UINT                    Levels,
  [in]          DWORD                   Usage,
  [in]          D3DFORMAT               Format,
  [in]          D3DPOOL                 Pool,
  [out, retval] IDirect3DVolumeTexture9 **ppVolumeTexture,
  [in]          HANDLE                  *pSharedHandle
);

Paramètres

[in] Width

Type : UINT

Largeur du niveau supérieur de la texture du volume, en pixels. Cette valeur doit être une puissance de deux si le D3DPTEXTURECAPS_VOLUMEMAP_POW2 membre de D3DCAPS9 est défini. Les dimensions de pixels des niveaux suivants seront la valeur tronquée de la moitié de la dimension de pixel du niveau précédent (indépendamment). Chaque dimension se serre à une taille de 1 pixel. Ainsi, si la division par deux aboutit à 0 (zéro), 1 sera pris à la place. La dimension maximale prise en charge par un pilote (pour la largeur, la hauteur et la profondeur) se trouve dans MaxVolumeExtent dans D3DCAPS9.

[in] Height

Type : UINT

Hauteur du niveau supérieur de la texture du volume, en pixels. Cette valeur doit être une puissance de deux si le D3DPTEXTURECAPS_VOLUMEMAP_POW2 membre de D3DCAPS9 est défini. Les dimensions de pixels des niveaux suivants seront la valeur tronquée de la moitié de la dimension de pixel du niveau précédent (indépendamment). Chaque dimension se serre à une taille de 1 pixel. Ainsi, si la division par 2 aboutit à 0 (zéro), 1 sera pris à la place. La dimension maximale prise en charge par un pilote (pour la largeur, la hauteur et la profondeur) se trouve dans MaxVolumeExtent dans D3DCAPS9.

[in] Depth

Type : UINT

Profondeur du niveau supérieur de la texture du volume, en pixels. Cette valeur doit être une puissance de deux si le D3DPTEXTURECAPS_VOLUMEMAP_POW2 membre de D3DCAPS9 est défini. Les dimensions de pixels des niveaux suivants seront la valeur tronquée de la moitié de la dimension de pixel du niveau précédent (indépendamment). Chaque dimension se serre à une taille de 1 pixel. Ainsi, si la division par 2 aboutit à 0 (zéro), 1 sera pris à la place. La dimension maximale prise en charge par un pilote (pour la largeur, la hauteur et la profondeur) se trouve dans MaxVolumeExtent dans D3DCAPS9.

[in] Levels

Type : UINT

Nombre de niveaux dans la texture. Si cette valeur est égale à zéro, Direct3D génère tous les sous-niveaux de texture jusqu’à 1 x 1 pixels pour le matériel qui prend en charge les textures de volume mipmapped. Appelez IDirect3DBaseTexture9 ::GetLevelCount pour voir le nombre de niveaux générés.

[in] Usage

Type : DWORD

L’utilisation peut être 0, ce qui indique aucune valeur d’utilisation. Si l’utilisation est souhaitée, utilisez D3DUSAGE_DYNAMIC ou D3DUSAGE_SOFTWAREPROCESSING. Pour plus d’informations, consultez D3DUSAGE.

[in] Format

Type : D3DFORMAT

Membre du D3DFORMAT type énuméré, décrivant le format de tous les niveaux dans la texture de volume.

[in] Pool

Type : D3DPOOL

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

[out, retval] ppVolumeTexture

Type : IDirect3DVolumeTexture9**

Adresse d’un pointeur vers une interface IDirect3DVolumeTexture9 , représentant la ressource de texture de volume créée.

[in] pSharedHandle

Type : HANDLE*

Réservé. Définissez ce paramètre sur NULL. Ce paramètre peut être utilisé dans Direct3D 9 pour Windows Vista pour partager des ressources.

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 l’une des suivantes : D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.