Funzione D3DXCreateVolumeTexture

Crea una trama di volume vuota, regolando i parametri chiamanti in base alle esigenze.

Sintassi

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
);

Parametri

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntatore a un'interfaccia IDirect3DDevice9 che rappresenta il dispositivo da associare alla trama del volume.

Larghezza [in]

Tipo: UINT

Larghezza in pixel. Questo valore deve essere diverso da zero. La dimensione massima supportata da un driver (per larghezza, altezza e profondità) è disponibile in MaxVolumeExtent in D3DCAPS9.

Altezza [in]

Tipo: UINT

Altezza in pixel. Questo valore deve essere diverso da zero. La dimensione massima supportata da un driver (per larghezza, altezza e profondità) è disponibile in MaxVolumeExtent in D3DCAPS9.

Profondità [in]

Tipo: UINT

Profondità in pixel. Questo valore deve essere diverso da zero. La dimensione massima supportata da un driver (per larghezza, altezza e profondità) è disponibile in MaxVolumeExtent in D3DCAPS9.

MipLevels [in]

Tipo: UINT

Numero di livelli mip richiesti. Se questo valore è zero o D3DX_DEFAULT, viene creata una catena mipmap completa.

Utilizzo [in]

Tipo: DWORD

0 o D3DUSAGE_DYNAMIC. Per altre informazioni sull'uso di trame dinamiche, vedere Uso di trame dinamiche.

Formato [in]

Tipo: D3DFORMAT

Membro del tipo enumerato D3DFORMAT , che descrive il formato pixel richiesto per la trama del volume. La trama del volume restituito potrebbe avere un formato diverso da quello specificato da Format. Le applicazioni devono controllare il formato della trama del volume restituito.

Pool [in]

Tipo: D3DPOOL

Membro del tipo enumerato D3DPOOL , che descrive la classe di memoria in cui deve essere inserita la trama del volume.

ppVolumeTexture [out]

Tipo: LPDIRECT3DVOLUMETEXTURE9*

Indirizzo di un puntatore a un'interfaccia IDirect3DVolumeTexture9 che rappresenta l'oggetto trama del volume creato.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito viene D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL E_OUTOFMEMORY .

Commenti

Internamente, D3DXCreateVolumeTexture usa D3DXCheckVolumeTextureRequirements per regolare i parametri chiamanti. Di conseguenza, le chiamate a D3DXCreateVolumeTexture hanno spesso esito positivo in cui le chiamate a CreateVolumeTexture avranno esito negativo.

Requisiti

Requisito	Valore
Intestazione	D3dx9tex.h
Libreria	D3dx9.lib

Vedi anche

Funzioni trama in D3DX 9