Condividi tramite

D3D12_SHADER_CACHE_SESSION_DESC struttura (d3d12.h)

  • Articolo

Descrive una sessione della cache shader.

Sintassi

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;

Members

Identifier

Tipo: GUID

Identificatore univoco da assegnare a questa specifica cache. Le cache con identificatori diversi vengono archiviate affiancate. Le cache con lo stesso identificatore vengono condivise in tutte le sessioni nello stesso processo. La creazione di una cache del disco con lo stesso identificatore di una cache già esistente apre tale cache, a meno che la versione non corrisponda. In questo caso, se non sono presenti altre sessioni aperte a tale cache, viene cancellata e ricreata. Se sono presenti sessioni esistenti, ID3D12Device9::CreateShaderCacheSession restituisce DXGI_ERROR_ALREADY_EXISTS.

Mode

Tipo: D3D12_SHADER_CACHE_MODE

Specifica il tipo di cache.

Flags

Tipo: D3D12_SHADER_CACHE_FLAGS

Modifica il comportamento della cache.

MaximumInMemoryCacheSizeBytes

Tipo: UINT

Per le cache in memoria, questa è l'unica risorsa di archiviazione disponibile. Per le cache dei dischi, tutte le voci archiviate o trovate vengono archiviate temporaneamente in memoria, fino a quando non vengono rimosse da voci più recenti. Questo valore determina le dimensioni di tale archiviazione temporanea. Impostazione predefinita su 1 KB.

MaximumInMemoryCacheEntries

Tipo: UINT

Specifica il numero di voci che possono essere archiviate in memoria. Il valore predefinito è 128.

MaximumValueFileSizeBytes

Tipo: UINT

Per le cache dei dischi, controlla la dimensione massima del file. Il valore predefinito è 128 MB.

Version

Tipo: UINT64

Può essere usato per cancellare in modo implicito le cache quando viene eseguito un aggiornamento di un'applicazione o di un componente. Se la versione non corrisponde alla versione archiviata nella cache, verrà cancellata e ricreata.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 Build 20348
Server minimo supportato Windows 10 Build 20348
Intestazione d3d12.h

Vedi anche