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

Confira também

Funções de textura no D3DX 9