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

# D3D12_SHADER_CACHE_SESSION_DESC

> Décrit une session de cache de nuanceurs.

Décrit une session de cache de nuanceurs.

## Syntaxe

```cpp theme={null}
typedef struct D3D12_SHADER_CACHE_SESSION_DESC
{
    GUID Identifier;
    D3D12_SHADER_CACHE_MODE Mode;
    D3D12_SHADER_CACHE_FLAGS Flags;
    UINT MaximumInMemoryCacheSizeBytes;
    UINT MaximumInMemoryCacheEntries;
    UINT MaximumValueFileSizeBytes;
    UINT64 Version;
} D3D12_SHADER_CACHE_SESSION_DESC
```

### Membres

*Identifier*\
Type : GUID

Un identificateur unique à attribuer à ce cache précis. Les caches ayant des identificateurs différents sont stockés côte à côte. Les caches ayant le même identificateur sont partagés entre toutes les sessions d'un même processus. La création d'un cache sur disque ayant le même identificateur qu'un cache existant ouvre ce cache, sauf si la **Version** ne correspond pas. Dans ce cas, si aucune autre session n'est ouverte sur ce cache, celui-ci est effacé et recréé. S'il existe des sessions, [ID3D12Device9::CreateShaderCacheSession](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createshadercachesession_public) retourne **DXGI\_ERROR\_ALREADY\_EXISTS**.

*Mode*\
Type : D3D12\_SHADER\_CACHE\_MODE

Spécifie le type de cache.

*Flags*\
Type : D3D12\_SHADER\_CACHE\_FLAGS

Modifie le comportement du cache.

*MaximumInMemoryCacheSizeBytes*\
Type : UINT

Pour les caches en mémoire, il s'agit du seul stockage disponible. Pour les caches sur disque, toutes les entrées stockées ou trouvées sont temporairement stockées en mémoire, jusqu'à ce qu'elles soient évincées par des entrées plus récentes. Cette valeur détermine la taille de ce stockage temporaire. La valeur par défaut est 1 Ko.

*MaximumInMemoryCacheEntries*\
Type : UINT

Spécifie le nombre d'entrées pouvant être stockées en mémoire. La valeur par défaut est 128.

*MaximumValueFileSizeBytes*\
Type : UINT

Pour les caches sur disque, contrôle la taille maximale des fichiers. La valeur par défaut est 128 Mo.

*Version*\
Type : UINT64

Peut servir à effacer implicitement les caches lors d'une mise à jour d'une application ou d'un composant. Si la version ne correspond pas à celle stockée dans le cache, celui-ci sera effacé et recréé.

## Remarques

## Configuration requise

**En-tête :** d3d12\_xs.h ou d3d12\_x.h\
**Bibliothèque :** d3d12\_xs.lib ou d3d12\_x.lib\
**Plateformes prises en charge :** consoles XBOX Series et famille XBOX One

## Voir aussi

* [ID3D12Device9::CreateShaderCacheSession](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createshadercachesession_public)
* [API de cache de nuanceurs D3D12](https://microsoft.github.io/DirectX-Specs/d3d/ShaderCache.html)


## Related topics

- [ID3D12ShaderCacheSession::GetDesc](/fr-CA/reference/graphics/d3d12/interfaces/id3d12shadercachesession/methods/id3d12shadercachesession_getdesc_public.md)
- [D3D12_SHADER_CACHE_FLAGS](/fr-CA/reference/graphics/d3d12/enums/d3d12_shader_cache_flags_public.md)
- [CreateShaderCacheSession (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createshadercachesession_public.md)
- [D3D12_SHADER_CACHE_MODE](/fr-CA/reference/graphics/d3d12/enums/d3d12_shader_cache_mode_public.md)
- [D3D12_SHADER_CACHE_SUPPORT_FLAGS](/fr-CA/reference/graphics/d3d12/enums/d3d12_shader_cache_support_flags_public.md)