Método ID3D12Device::GetResourceTiling (d3d12.h)
Obtém informações sobre como um recurso em blocos é dividido em blocos.
Sintaxe
void GetResourceTiling(
[in] ID3D12Resource *pTiledResource,
[out, optional] UINT *pNumTilesForEntireResource,
[out, optional] D3D12_PACKED_MIP_INFO *pPackedMipDesc,
[out, optional] D3D12_TILE_SHAPE *pStandardTileShapeForNonPackedMips,
[in, out, optional] UINT *pNumSubresourceTilings,
[in] UINT FirstSubresourceTilingToGet,
[out] D3D12_SUBRESOURCE_TILING *pSubresourceTilingsForNonPackedMips
);
Parâmetros
[in] pTiledResource
Tipo: ID3D12Resource*
Especifica uma ID3D12Resource em bloco para obter informações sobre.
[out, optional] pNumTilesForEntireResource
Tipo: UINT*
Um ponteiro para uma variável que recebe o número de blocos necessários para armazenar todo o recurso em bloco.
[out, optional] pPackedMipDesc
Tipo: D3D12_PACKED_MIP_INFO*
Um ponteiro para uma estrutura D3D12_PACKED_MIP_INFO que GetResourceTiling preenche com informações sobre como os mipmaps do recurso em bloco são empacotados.
[out, optional] pStandardTileShapeForNonPackedMips
Tipo: D3D12_TILE_SHAPE*
Especifica uma estrutura D3D12_TILE_SHAPE que GetResourceTiling preenche com informações sobre a forma do bloco. Estas são informações sobre como os pixels se encaixam nos blocos, independentemente das dimensões do recurso em bloco, sem incluir mipmaps empacotados. Se todo o recurso em bloco estiver empacotado, esse parâmetro não terá sentido porque o recurso em bloco não tem um layout definido para mipmaps empacotados. Nessa situação, GetResourceTiling define os membros do D3D12_TILE_SHAPE como zeros.
[in, out, optional] pNumSubresourceTilings
Tipo: UINT*
Um ponteiro para uma variável que contém o número de blocos na sub-fonte. Na entrada, esse é o número de sub-recursos para consultar blocos; na saída, esse é o número que foi realmente recuperado em pSubresourceTilingsForNonPackedMips (fixado ao que está disponível).
[in] FirstSubresourceTilingToGet
Tipo: UINT
O número do primeiro bloco de sub-recursos a ser obtido. GetResourceTiling ignora esse parâmetro se o número para o qual pNumSubresourceTilings aponta é 0.
[out] pSubresourceTilingsForNonPackedMips
Tipo: D3D12_SUBRESOURCE_TILING*
Especifica uma estrutura D3D12_SUBRESOURCE_TILING que GetResourceTiling preenche com informações sobre blocos de sub-fonte. Se os blocos de sub-recursos fizerem parte de mipmaps empacotados, GetResourceTiling definirá os membros de D3D12_SUBRESOURCE_TILING como zeros, exceto o membro StartTileIndexInOverallResource , que GetResourceTiling define como D3D12_PACKED_TILE (0xffffffff). A constante D3D12_PACKED_TILE indica que toda a estrutura D3D12_SUBRESOURCE_TILING não tem sentido para essa situação e as informações às quais o parâmetro pPackedMipDesc aponta se aplicam.
Valor retornado
Nenhum
Comentários
Para estimar o tamanho total do recurso de texturas necessárias ao calcular tamanhos de heap e chamar CreatePlacedResource, use GetResourceAllocationInfo em vez de GetResourceTiling. GetResourceTiling não pode ser usado para isso.
Para obter mais informações sobre recursos em bloco, consulte Recursos em bloco de volume.
Requisitos
Plataforma de Destino | Windows |
Cabeçalho | d3d12.h |
Biblioteca | D3d12.lib |
DLL | D3d12.dll |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de