Função D3DXCheckVolumeTextureRequirements

Verifica os parâmetros de criação de textura de volume.

Sintaxe

HRESULT D3DXCheckVolumeTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pWidth,
  _Inout_ UINT              *pHeight,
  _Inout_ UINT              *pDepth,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

Parâmetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

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

pWidth [in, out]

Tipo: UINT*

Ponteiro para a largura solicitada em pixels ou NULL. Retorna o tamanho corrigido.

pHeight [in, out]

Tipo: UINT*

Ponteiro para a altura solicitada em pixels ou NULL. Retorna o tamanho corrigido.

pDepth [in, out]

Tipo: UINT*

Ponteiro para a profundidade solicitada em pixels ou NULL. Retorna o tamanho corrigido.

pNumMipLevels [in, out]

Tipo: UINT*

Ponteiro para o número de níveis de mipmap solicitados ou NULL. Retorna o número corrigido de níveis de mipmap.

Uso [in]

Tipo: DWORD

Atualmente não usado, defina como 0.

pFormat [in, out]

Tipo: D3DFORMAT*

Ponteiro para um membro do tipo enumerado D3DFORMAT . Especifica o formato de pixel desejado ou NULL. Retorna o formato corrigido.

Pool [in]

Tipo: D3DPOOL

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

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_INVALIDCALL.

Comentários

Se os parâmetros para essa função forem inválidos, essa função retornará parâmetros corrigidos.

Requisitos

Confira também

Funções de textura no D3DX 9