structure D3D12_SHADER_CACHE_SESSION_DESC (d3d12.h)

  • Article

Décrit une session de cache de nuanceur.

Syntaxe

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

Identificateur unique à donner à ce cache spécifique. Les caches avec différents identificateurs sont stockés côte à côte. Les caches avec le même identificateur sont partagés entre toutes les sessions du même processus. La création d’un cache de disque avec le même identificateur qu’un cache déjà existant ouvre ce cache, sauf si la version ne correspond pas. Dans ce cas, si aucune autre session n’est ouverte à ce cache, celui-ci est effacé et recréé. S’il existe des sessions existantes, ID3D12Device9 ::CreateShaderCacheSession 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 de disque, toutes les entrées stockées ou trouvées sont temporairement stockées en mémoire, jusqu’à ce qu’elles soient supprimées par des entrées plus récentes. Cette valeur détermine la taille de ce stockage temporaire. Par défaut, 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 de disque, contrôle la taille maximale du fichier. Par défaut, 128 Mo.

Version

Type : UINT64

Peut être utilisé pour effacer implicitement les caches lorsqu’une mise à jour d’application ou de composant est effectuée. Si la version ne correspond pas à la version stockée dans le cache, elle est réinitialisation et recréée.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 Build 20348
Serveur minimal pris en charge Windows 10 Build 20348
En-tête d3d12.h

Voir aussi