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

# XGComputeTexture1DLayout (família XBOX One)

> Calcula o layout de hardware para uma textura 1D.

Calcula o layout de hardware para uma textura 1D.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT XGComputeTexture1DLayout(
         const XG_TEXTURE1D_DESC *pDesc,
         XG_RESOURCE_LAYOUT *pLayout
)  
```

<a id="ID4EU" />

### Parâmetros

*pDesc*   \_In\_<br />Tipo: [XG\_TEXTURE1D\_DESC\*](/pt-BR/reference/graphics/xg__NR/structs/xg_texture1d_desc)

A descrição de uma textura 1D como um ponteiro para uma estrutura [XG\_TEXTURE1D\_DESC](/pt-BR/reference/graphics/xg__NR/structs/xg_texture1d_desc).

*pLayout*   \_Out\_<br />Tipo: [XG\_RESOURCE\_LAYOUT\*](/pt-BR/reference/graphics/xg__NR/structs/xg_resource_layout)

O layout de hardware como um ponteiro para uma estrutura [XG\_RESOURCE\_LAYOUT](/pt-BR/reference/graphics/xg__NR/structs/xg_resource_layout).

<a id="ID4E3" />

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

Use esta função de conveniência em vez de criar um computador de textura quando você só precisar calcular um layout e não precisar usar nenhum dos outros recursos de um computador de textura. Esta função cria internamente um computador de textura, chama o [método XGTextureAddressComputer::GetResourceLayout](/pt-BR/reference/graphics/xg__NR/interfaces/XGTextureAddressComputer/methods/xgtextureaddresscomputer_getresourcelayout) e, em seguida, libera o computador de textura.

Se qualquer um dos seguintes casos ocorrer, a função retornará **E\_INVALIDARG**:

* Se *pDesc* ou *pLayout* forem nulos.
* Se **XG\_TEXTURE1D\_DESC.Usage** for XG\_USAGE\_DYNAMIC. Recursos offline não podem ter uso dinâmico.
* Se **XG\_TEXTURE1D\_DESC.Pitch** não for 0.
* Se **XG\_TEXTURE1D\_DESC.Usage** for XG\_USAGE\_STAGING e **XG\_TEXTURE1D\_DESC.TileMode** não for XG\_TILE\_MODE\_LINEAR. Somente modos de disposição em blocos lineares têm suporte com recursos de preparo.
* Se os sinalizadores de **XG\_TEXTURE1D\_DESC** não forem válidos.

<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

- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [LoadComputePipeline](/es/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_loadcomputepipeline_public.md)
- [SetComputeRootSignature](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setcomputerootsignature_public.md)
- [CreateComputePipelineState](/es/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcomputepipelinestate_public.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)