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

# XGComputeTileShape (família XBOX One)

> Retorna a forma de um único bloco de recurso em blocos para o formato especificado.

Retorna a forma de um único bloco de recurso em blocos para o formato especificado.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT XGComputeTileShape(
         XG_RESOURCE_DIMENSION Dimension,
         XG_FORMAT Format,
         UINT32 BytesPerElement,
         UINT32 SampleCount,
         XG_TILE_SHAPE *pTileShapeInTexels,
         XG_TILE_SHAPE_ELEMENTS *pTileShapeInElements
)  
```

<a id="ID4EG" />

### Parâmetros

*Dimension*   \_In\_<br />Tipo: [XG\_RESOURCE\_DIMENSION](/pt-BR/reference/graphics/xg__NR/enums/xg_resource_dimension)

A dimensão do recurso como uma constante de enumeração [XG\_RESOURCE\_DIMENSION](/pt-BR/reference/graphics/xg__NR/enums/xg_resource_dimension), como para desconhecido, buffer, textura 1D, textura 2D ou textura 3D.

*Format*   \_In\_<br />Tipo: [XG\_FORMAT](/pt-BR/reference/graphics/xg__NR/enums/xg_format)

O formato como uma constante de enumeração [XG\_FORMAT](/pt-BR/reference/graphics/xg__NR/enums/xg_format), como XG\_FORMAT\_R32G32B32\_UINT.

* Se *Format* for XG\_FORMAT\_UNKNOWN, o parâmetro *BytesPerElement* será usado em seu lugar, e *BytesPerElement* deverá ser 1, 2, 4, 8 ou 16 bytes.
* Se *Format* não for XG\_FORMAT\_UNKNOWN, o valor de *BytesPerElement* será ignorado e calculado por esta função.

*BytesPerElement*   \_In\_<br />Tipo: UINT32

Os bytes por elemento, como um UINT32.

*SampleCount*   \_In\_<br />Tipo: UINT32

Para todas as dimensões de recurso diferentes de Texture2D, *SampleCount* deve ser 1. Para Texture2D, *SampleCount* deve ser 1, 2, 4 ou 8.

*pTileShapeInTexels*   \_Out\_opt\_<br />Tipo: [XG\_TILE\_SHAPE\*](/pt-BR/reference/graphics/xg__NR/structs/xg_tile_shape)

A forma do bloco, em texels, como um ponteiro para uma estrutura [XG\_TILE\_SHAPE](/pt-BR/reference/graphics/xg__NR/structs/xg_tile_shape). Se *Format* for XG\_FORMAT\_UNKNOWN, *pTileShapeInTexels* será preenchido com zeros, se estiver presente.

*pTileShapeInElements*   \_Out\_opt\_<br />Tipo: [XG\_TILE\_SHAPE\_ELEMENTS\*](/pt-BR/reference/graphics/xg__NR/structs/xg_tile_shape_elements)

A forma do bloco, em elementos, como um ponteiro para uma estrutura [XG\_TILE\_SHAPE\_ELEMENTS](/pt-BR/reference/graphics/xg__NR/structs/xg_tile_shape_elements).

<a id="ID4EO" />

### Valor retornado

Tipo: [HRESULT](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

Retornará **S\_OK** se tiver êxito; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, confira [Códigos de erro](/pt-BR/reference/errorcodes).

<a id="remarks" />

## Comentários

Esta função retorna a forma de um único bloco de recurso em blocos para o formato especificado. A forma do bloco é retornada em unidades de texels e também de elementos.

<a id="requirements" />

## Requisitos

**Cabeçalho:** xg.h

**Biblioteca:** xg\_x.lib

**Plataformas com suporte:** família XBOX One

## Confira também

[Referência do XG](/pt-BR/reference/graphics/xg__NR/xg_members)


## Related topics

- [D3D12_TILE_SHAPE](/pt-BR/reference/graphics/d3d12/structs/d3d12_tile_shape_public.md)
- [CopyTiles](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copytiles_public.md)
- [CopyTileMappings](/pt-BR/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public.md)
- [LoadComputePipeline](/pt-BR/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_loadcomputepipeline_public.md)
- [D3D12_TILE_COPY_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_tile_copy_flags_public.md)