Método ID3D12Device::GetResourceTiling (d3d12.h)

Artigo
07/16/2024

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 um ID3D12Resource em blocos para obter informações.

[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 de 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 número do primeiro bloco de sub-fonte a ser obtido. GetResourceTiling ignorará esse parâmetro se o número que pNumSubresourceTilings apontar 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-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 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 bloco, consulte de 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

sub-recursos

Compartilhar via