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 blocos.

[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. Essas são informações sobre como os pixels se encaixam nos blocos, independentemente das dimensões do recurso em blocos, não incluindo 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 layout definido para mipmaps empacotados. Nessa situação, GetResourceTiling define os membros de 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 índice do primeiro bloco de sub-fonte a ser obtido. GetResourceTiling ignorará esse parâmetro se o número para o qual pNumSubresourceTilings aponta for 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-fonte 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 para se aplicar.

Valor de retorno

Nenhum

Observações

Para estimar o tamanho total de recursos 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 blocos, consulte Os Recursos em Blocos de Volume.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	d3d12.h
Biblioteca	D3d12.lib
de DLL	D3d12.dll

Consulte também

ID3D12Device

subrecursos