Função D3DXCheckTextureRequirements

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

Sintaxe

HRESULT D3DXCheckTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pWidth,
  _Inout_ UINT              *pHeight,
  _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.

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.

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

Comentários

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

Essa função usa a seguinte heurística ao comparar os requisitos solicitados com os formatos disponíveis:

• Não escolha um formato que tenha menos canais.
• Evite formatos FOURCC e 24 bits, a menos que seja solicitado explicitamente.
• Tente não adicionar novos canais.
• Tente não alterar o número de bits por canal.
• Tente evitar a conversão entre tipos de formatos. Por exemplo, evite converter um formato ARGB em um formato de profundidade.

Requisitos

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

Confira também

Funções de textura no D3DX 9