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