Função D3DXCheckCubeTextureRequirements

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

Sintaxe

HRESULT D3DXCheckCubeTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pSize,
  _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 cubo.

pSize [in, out]

Tipo: UINT*

Ponteiro para a largura e altura solicitadas 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

0 ou D3DUSAGE_RENDERTARGET. Definir esse sinalizador como D3DUSAGE_RENDERTARGET indica que a superfície deve ser usada como um destino de renderização. Em seguida, o recurso pode ser passado para o parâmetro pNewRenderTarget do método SetRenderTarget . Se D3DUSAGE_RENDERTARGET for especificado, o aplicativo deverá marcar que o dispositivo dê suporte a essa operação chamando CheckDeviceFormat.

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

As texturas de cubo diferem de outras superfícies, pois são coleções de superfícies. Para chamar SetRenderTarget com uma textura de cubo, você deve selecionar um rosto individual usando GetCubeMapSurface e passar a superfície resultante para SetRenderTarget.

Requisitos

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

Confira também

Funções de textura no D3DX 9