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

ID3D12Device

Sub-recursos