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 |
|
| Libreria |
|
Vedi anche