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

# XBTCCreateLinearTexture

> Cria e aloca um contêiner de textura para uma textura linear.

Cria e aloca um contêiner de textura para uma textura linear.

## Sintaxe

```cpp theme={null}
HRESULT XBTCCreateLinearTexture(  
         XBTCTextureContainer** ppLinearTexture,  
         XBTC_TEX_DIMENSION Dimension,  
         DXGI_FORMAT Format,  
         size_t Width,  
         size_t Height,  
         size_t DepthOrArraySize,  
         int8_t MipCount  
)  
```

### Parâmetros

*ppLinearTexture*   \_Out\_\
Tipo: XBTCTextureContainer\*\*

Um ponteiro para um `XBTCTextureContainer`.

*Dimension*   \_In\_\
Tipo: [XBTC\_TEX\_DIMENSION](/pt-BR/reference/graphics/xbtc/enums/xbtc_tex_dimension)

Seleção da enumeração de dimensões de textura.

*Format*   \_In\_\
Tipo: DXGI\_FORMAT

Formato da textura (para BCPack).

*Width*   \_In\_\
Tipo: size\_t

Largura, em pixels, do mip 0.

*Height*   \_In\_\
Tipo: size\_t

Altura, em pixels, do mip 0.

*DepthOrArraySize*   \_In\_\
Tipo: size\_t

Tamanho total da profundidade ou tamanho da matriz.

*MipCount*   \_In\_\
Tipo: int8\_t

Número total de níveis de detalhe (LODs). Passar -1 reservará a cadeia de mips completa.

### Valor retornado

Tipo: HRESULT

Retorna `S_OK` se tiver êxito; caso contrário, retorna um código de erro HRESULT.

## Comentários

`XBTCCreateLinearTexture` cria e aloca um contêiner de textura para uma textura linear.
A organização genérica da textura é semelhante à de um arquivo DirectDraw Surface (DDS) do DirectX.\
Na memória, os sub-recursos são organizados de forma compacta em ordem crescente.
Os níveis de mip de maior resolução precedem os de menor resolução em relação aos índices de LOD.
As matrizes de texturas têm cadeias de mips contíguas para cada elemento da matriz.
Para obter mais informações sobre a dimensionalidade da textura, confira [XBTC\_TEX\_DIMENSION](/pt-BR/reference/graphics/xbtc/enums/xbtc_tex_dimension).

## Requisitos

**Cabeçalho:** XBTC.h

**Plataformas com suporte**: consoles da família XBOX One e consoles XBOX Series

## Confira também

[XBTC\_TEXTURE\_INFO](/pt-BR/reference/graphics/xbtc/structs/xbtc_texture_info)
[XBTC](/pt-BR/reference/graphics/xbtc/xbtc_members)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [CopyTiles](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copytiles_public.md)
- [GameInputForceFeedbackMagnitude](/pt-BR/reference/input/gameinput/structs/gameinputforcefeedbackmagnitude.md)
- [D3D12_FILTER](/pt-BR/reference/graphics/d3d12/enums/d3d12_filter_public.md)
- [CreatePlacedResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public.md)