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 |
|
| Biblioteca |
|
Confira também