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

> Crée et alloue un conteneur de texture pour une texture linéaire.

Crée et alloue un conteneur de texture pour une texture linéaire.

## Syntaxe

```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  
)  
```

### Paramètres

*ppLinearTexture*   \_Out\_\
Type : XBTCTextureContainer\*\*

Pointeur vers un `XBTCTextureContainer`.

*Dimension*   \_In\_\
Type : [XBTC\_TEX\_DIMENSION](/fr-CA/reference/graphics/xbtc/enums/xbtc_tex_dimension)

Valeur choisie dans l'énumération des dimensions de texture.

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

Format de texture (pour BCPack).

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

Largeur, en pixels, du mip 0.

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

Hauteur, en pixels, du mip 0.

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

Taille totale de la profondeur ou taille du tableau.

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

Nombre total de niveaux de détail (LOD). La valeur -1 réserve la chaîne de mips complète.

### Valeur de retour

Type : HRESULT

Retourne `S_OK` en cas de réussite; sinon, retourne un code d'erreur HRESULT.

## Remarques

`XBTCCreateLinearTexture` crée et alloue un conteneur de texture pour une texture linéaire.
La disposition générique de la texture est semblable à celle d'un fichier DirectX DirectDraw Surface (DDS).\
En mémoire, les sous-ressources sont disposées de façon compacte en ordre croissant.
Les niveaux de mip de plus haute résolution précèdent les plus petits selon les indices de LOD.
Les tableaux de textures ont des chaînes de mips contiguës pour chaque élément du tableau.
Pour plus d'informations sur la dimensionnalité des textures, consultez [XBTC\_TEX\_DIMENSION](/fr-CA/reference/graphics/xbtc/enums/xbtc_tex_dimension).

## Configuration requise

**En-tête :** XBTC.h

**Plateformes prises en charge** : consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

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


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [D3D12_FILTER_TYPE](/fr-CA/reference/graphics/d3d12/enums/d3d12_filter_type_public.md)
- [CreateSampler](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createsampler_public.md)
- [CreatePlacedResource](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public.md)
- [CreateShaderResourceView](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createshaderresourceview_public.md)