Metodo IDirect3DDevice9::CreateVolumeTexture (d3d9helper.h)

Articolo
03/05/2024

Crea una risorsa trama del volume.

Sintassi

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

Parametri

[in] Width

Tipo: UINT

Larghezza del livello superiore della trama del volume, in pixel. Questo valore deve essere una potenza di due se il membro D3DPTEXTURECAPS_VOLUMEMAP_POW2 di D3DCAPS9 è impostato. Le dimensioni dei pixel dei livelli successivi saranno il valore troncato della metà della dimensione pixel del livello precedente (in modo indipendente). Ogni dimensione si blocca a una dimensione di 1 pixel. Pertanto, se la divisione per due risultati in 0 (zero), 1 verrà invece presa. La dimensione massima supportata da un driver (per larghezza, altezza e profondità) è disponibile in MaxVolumeExtent in D3DCAPS9.

[in] Height

Tipo: UINT

Altezza del livello superiore della trama del volume, in pixel. Questo valore deve essere una potenza di due se il membro D3DPTEXTURECAPS_VOLUMEMAP_POW2 di D3DCAPS9 è impostato. Le dimensioni dei pixel dei livelli successivi saranno il valore troncato della metà della dimensione pixel del livello precedente (in modo indipendente). Ogni dimensione si blocca a una dimensione di 1 pixel. Pertanto, se la divisione per 2 risultati in 0 (zero), 1 verrà invece presa. La dimensione massima supportata da un driver (per larghezza, altezza e profondità) è disponibile in MaxVolumeExtent in D3DCAPS9.

[in] Depth

Tipo: UINT

Profondità del livello superiore della trama del volume, in pixel. Questo valore deve essere una potenza di due se il membro D3DPTEXTURECAPS_VOLUMEMAP_POW2 di D3DCAPS9 è impostato. Le dimensioni dei pixel dei livelli successivi saranno il valore troncato della metà della dimensione pixel del livello precedente (in modo indipendente). Ogni dimensione si blocca a una dimensione di 1 pixel. Pertanto, se la divisione per 2 risultati in 0 (zero), 1 verrà invece presa. La dimensione massima supportata da un driver (per larghezza, altezza e profondità) è disponibile in MaxVolumeExtent in D3DCAPS9.

[in] Levels

Tipo: UINT

Numero di livelli nella trama. Se si tratta di zero, Direct3D genererà tutte le trame sublevel fino a 1x1 pixel per l'hardware che supporta trame di volumi mipmapped. Chiamare IDirect3DBaseTexture9::GetLevelCount per visualizzare il numero di livelli generati.

[in] Usage

Tipo: DWORD

L'utilizzo può essere 0, che indica nessun valore di utilizzo. Se si desidera usare D3DUSAGE_DYNAMIC o D3DUSAGE_SOFTWAREPROCESSING. Per altre informazioni, vedere D3DUSAGE.

[in] Format

Tipo: D3DFORMAT

Membro del tipo enumerato D3DFORMAT , che descrive il formato di tutti i livelli nella trama del volume.

[in] Pool

Tipo: D3DPOOL

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

[out, retval] ppVolumeTexture

Tipo: IDirect3DVolumeTexture9**

Indirizzo di un puntatore a un'interfaccia IDirect3DVolumeTexture9 che rappresenta la risorsa trama del volume creata.

[in] pSharedHandle

Tipo: HANDLE*

Riservato. Impostare questo parametro su NULL. Questo parametro può essere usato in Direct3D 9 per Windows Vista per condividere le risorse.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.