> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetResourceTiling

> Obtém informações sobre como um recurso lado a lado é dividido em blocos. (ID3D12Device.GetResourceTiling)

Obtém informações sobre como um recurso lado a lado é dividido em blocos.

## Sintaxe

```cpp theme={null}
void GetResourceTiling(
    ID3D12Resource  pTiledResource,
    UINT  pNumTilesForEntireResource,
    D3D12_PACKED_MIP_INFO  pPackedMipDesc,
    D3D12_TILE_SHAPE  pStandardTileShapeForNonPackedMips,
    UINT  pNumSubresourceTilings,
    UINT FirstSubresourceTilingToGet,
    D3D12_SUBRESOURCE_TILING  pSubresourceTilingsForNonPackedMips
)
```

### Parâmetros

*pTiledResource \[in]*\
Tipo: ID3D12Resource \*

Especifica um [ID3D12Resource](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs) 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](/pt-BR/reference/graphics/d3d12/structs/d3d12_packed_mip_info_public) 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](/pt-BR/reference/graphics/d3d12/structs/d3d12_tile_shape_public) 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 <i>pSubresourceTilingsForNonPackedMips</i> (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 <i>pNumSubresourceTilings</i> aponta for 0.

*pSubresourceTilingsForNonPackedMips \[out]*\
Tipo: D3D12\_SUBRESOURCE\_TILING \*

Especifica uma estrutura [D3D12\_SUBRESOURCE\_TILING](/pt-BR/reference/graphics/d3d12/structs/d3d12_subresource_tiling_public) 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 <i>StartTileIndexInOverallResource</i>, 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 <i>pPackedMipDesc</i> 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](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public), use [GetResourceAllocationInfo](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getresourceallocationinfo_public) 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](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/volume-tiled-resources).

## 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](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)

[Sub-recursos](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/subresources)


## Related topics

- [D3D12_SUBRESOURCE_TILING](/pt-BR/reference/graphics/d3d12/structs/d3d12_subresource_tiling_public.md)
- [GetResourceAllocationInfo](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getresourceallocationinfo_public.md)
- [D3D12_TILE_SHAPE](/pt-BR/reference/graphics/d3d12/structs/d3d12_tile_shape_public.md)
- [GetResourceAllocationInfo1 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_getresourceallocationinfo1_public.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)