Função D3DXCreateVolumeTexture

Cria uma textura de volume vazia, ajustando os parâmetros de chamada conforme necessário.

Sintaxe

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

Parâmetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Ponteiro para uma interface IDirect3DDevice9 , representando o dispositivo a ser associado à textura do volume.

Largura [in]

Tipo: UINT

Largura em pixels. Esse valor deve ser diferente de zero. A dimensão máxima compatível com um driver (para largura, altura e profundidade) pode ser encontrada em MaxVolumeExtent em D3DCAPS9.

Altura [in]

Tipo: UINT

Altura em pixels. Esse valor deve ser diferente de zero. A dimensão máxima compatível com um driver (para largura, altura e profundidade) pode ser encontrada em MaxVolumeExtent em D3DCAPS9.

Profundidade [in]

Tipo: UINT

Profundidade em pixels. Esse valor deve ser diferente de zero. A dimensão máxima compatível com um driver (para largura, altura e profundidade) pode ser encontrada em MaxVolumeExtent em D3DCAPS9.

MipLevels [in]

Tipo: UINT

Número de níveis de mip solicitados. Se esse valor for zero ou D3DX_DEFAULT, uma cadeia de mipmap completa será criada.

Uso [in]

Tipo: DWORD

0 ou D3DUSAGE_DYNAMIC. Para obter mais informações sobre como usar texturas dinâmicas, consulte Usando texturas dinâmicas.

Formatar [in]

Tipo: D3DFORMAT

Membro do tipo enumerado D3DFORMAT , descrevendo o formato de pixel solicitado para a textura do volume. A textura de volume retornada pode ter um formato diferente daquele especificado por Format. Os aplicativos devem marcar o formato da textura de volume retornada.

Pool [in]

Tipo: D3DPOOL

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

ppVolumeTexture [out]

Tipo: LPDIRECT3DVOLUMETEXTURE9*

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

Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, o valor retornado será D3D_OK. Se a função falhar, o valor retornado poderá ser um dos seguintes: D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL E_OUTOFMEMORY .

Comentários

Internamente, D3DXCreateVolumeTexture usa D3DXCheckVolumeTextureRequirements para ajustar os parâmetros de chamada. Portanto, as chamadas para D3DXCreateVolumeTexture geralmente terão êxito quando as chamadas para CreateVolumeTexture falharem.

Requisitos

Requisito	Valor
parâmetro	D3dx9tex.h
Biblioteca	D3dx9.lib

Confira também

Funções de textura no D3DX 9