Pular para o conteúdo principal
Obtém informações sobre como um recurso lado a lado é dividido em blocos.

Sintaxe

Parâmetros

pTiledResource [in]
Tipo: ID3D12Resource *
Especifica um ID3D12Resource lado a lado sobre o qual obter informações. pNumTilesForEntireResource [out, optional]
Tipo: UINT *
Um ponteiro para uma variável que recebe o número de blocos necessários para armazenar todo o recurso lado a lado. pPackedMipDesc [out, optional]
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 lado a lado são empacotados. pStandardTileShapeForNonPackedMips [out, optional]
Tipo: D3D12_TILE_SHAPE *
Especifica uma estrutura D3D12_TILE_SHAPE que GetResourceTiling preenche com informações sobre a forma do bloco. Essas são informações sobre como os pixels se encaixam nos blocos, independentemente das dimensões do recurso lado a lado, sem incluir mipmaps empacotados. Se todo o recurso lado a lado estiver empacotado, este parâmetro não terá significado, pois o recurso lado a lado não tem layout definido para mipmaps empacotados. Nessa situação, GetResourceTiling define os membros de D3D12_TILE_SHAPE como zeros. pNumSubresourceTilings [in, out, optional]
Tipo: UINT *
Um ponteiro para uma variável que contém o número de blocos no sub-recurso. Na entrada, este é o número de sub-recursos cujos arranjos de blocos serão consultados; na saída, este é o número que foi realmente recuperado em pSubresourceTilingsForNonPackedMips (limitado ao que está disponível). FirstSubresourceTilingToGet [in]
Tipo: UINT
O número do primeiro bloco de sub-recurso a ser obtido. GetResourceTiling ignora este parâmetro se o número para o qual pNumSubresourceTilings aponta for 0. pSubresourceTilingsForNonPackedMips [out]
Tipo: D3D12_SUBRESOURCE_TILING *
Especifica uma estrutura D3D12_SUBRESOURCE_TILING que GetResourceTiling preenche com informações sobre os blocos de sub-recursos. 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 significado nessa situação, e as informações para as quais o parâmetro pPackedMipDesc aponta se aplicam.

Valor retornado

Tipo: void Nenhum.

Comentários

Para estimar o tamanho total dos recursos de textura necessário 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 lado a lado, consulte Recursos lado a lado de volume.

Requisitos

Cabeçalho: d3d12_xs.h ou d3d12_x.h
Biblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One

Confira também

ID3D12Device Sub-recursos
Última modificação em 6 de outubro de 2026