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

Artigo
08/23/2023

Cria um recurso de textura de volume.

Sintaxe

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

Parâmetros

[in] Width

Tipo: UINT

Largura do nível superior da textura do volume, em pixels. Esse valor deverá ser uma potência de dois se o membro D3DPTEXTURECAPS_VOLUMEMAP_POW2 de D3DCAPS9 estiver definido. As dimensões de pixel dos níveis subsequentes serão o valor truncado de metade da dimensão de pixel do nível anterior (independentemente). Cada dimensão é fixada em um tamanho de 1 pixel. Portanto, se a divisão por dois resultar em 0 (zero), 1 será tomada em vez disso. A dimensão máxima compatível com um driver (para largura, altura e profundidade) pode ser encontrada em MaxVolumeExtent em D3DCAPS9.

[in] Height

Tipo: UINT

Altura do nível superior da textura do volume, em pixels. Esse valor deverá ser uma potência de dois se o membro D3DPTEXTURECAPS_VOLUMEMAP_POW2 de D3DCAPS9 estiver definido. As dimensões de pixel dos níveis subsequentes serão o valor truncado de metade da dimensão de pixel do nível anterior (independentemente). Cada dimensão é fixada em um tamanho de 1 pixel. Assim, se a divisão por 2 resultar em 0 (zero), 1 será tomada em vez disso. A dimensão máxima compatível com um driver (para largura, altura e profundidade) pode ser encontrada em MaxVolumeExtent em D3DCAPS9.

[in] Depth

Tipo: UINT

Profundidade do nível superior da textura do volume, em pixels. Esse valor deverá ser uma potência de dois se o membro D3DPTEXTURECAPS_VOLUMEMAP_POW2 de D3DCAPS9 estiver definido. As dimensões de pixel dos níveis subsequentes serão o valor truncado de metade da dimensão de pixel do nível anterior (independentemente). Cada dimensão é fixada em um tamanho de 1 pixel. Assim, se a divisão por 2 resultar em 0 (zero), 1 será tomada em vez disso. A dimensão máxima compatível com um driver (para largura, altura e profundidade) pode ser encontrada em MaxVolumeExtent em D3DCAPS9.

[in] Levels

Tipo: UINT

Número de níveis na textura. Se isso for zero, o Direct3D gerará todos os subnível de textura até 1x1 pixels para hardware que dá suporte a texturas de volume mipmapped. Chame IDirect3DBaseTexture9::GetLevelCount para ver o número de níveis gerados.

[in] Usage

Tipo: DWORD

O uso pode ser 0, o que indica nenhum valor de uso. Se o uso for desejado, use D3DUSAGE_DYNAMIC ou D3DUSAGE_SOFTWAREPROCESSING. Para obter mais informações, consulte D3DUSAGE.

[in] Format

Tipo: D3DFORMAT

Membro do D3DFORMAT tipo enumerado, descrevendo o formato de todos os níveis na textura do volume.

[in] Pool

Tipo: D3DPOOL

Membro do D3DPOOL tipo enumerado, descrevendo a classe de memória na qual a textura do volume deve ser colocada.

[out, retval] ppVolumeTexture

Tipo: IDirect3DVolumeTexture9**

Endereço de um ponteiro para uma interface IDirect3DVolumeTexture9 , representando o recurso de textura de volume criado.

[in] pSharedHandle

Tipo: HANDLE*

Reservado. Defina esse parâmetro como NULL. Esse parâmetro pode ser usado no Direct3D 9 para o Windows Vista compartilhar recursos.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY.