D3D12_SHADER_CACHE_SESSION_DESC 結構 (d3d12.h)

描述著色器快取會話。

語法

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;

成員

Identifier

類型： GUID

要提供給這個特定快取的唯一標識符。 具有不同標識碼的快取會並存儲存。 具有相同標識碼的快取會在相同進程中的所有會話之間共用。 除非 版本 不相符，否則建立與現有快取相同標識符的磁碟快取會開啟該快取。 在此情況下，如果沒有其他會話開啟至該快取，則會清除並重新建立。 如果有現有的會話，則 ID3D12Device9：：CreateShaderCacheSession 會 傳回DXGI_ERROR_ALREADY_EXISTS。

Mode

類型： D3D12_SHADER_CACHE_MODE

指定快取的類型。

Flags

類型： D3D12_SHADER_CACHE_FLAGS

修改快取的行為。

MaximumInMemoryCacheSizeBytes

類型： UINT

對於記憶體內部快取，這是唯一可用的記憶體。 針對磁碟快取，所有儲存或找到的專案都會暫時儲存在記憶體中，直到由較新的專案收回為止。 這個值會決定該暫存記憶體的大小。 預設為 1KB。

MaximumInMemoryCacheEntries

類型： UINT

指定可以儲存在記憶體中的項目數目。 預設值為 128。

MaximumValueFileSizeBytes

類型： UINT

針對磁碟快取，控制檔案大小上限。 預設值為 128MB。

Version

類型： UINT64

當應用程式或元件更新完成時，可用來隱含清除快取。 如果版本不符合快取中儲存的版本，則會抹除並重新建立版本。

規格需求

需求	值
最低支援的用戶端	Windows 10 組建 20348
最低支援的伺服器	Windows 10 組建 20348
標頭	d3d12.h

另請參閱

• ID3D12Device9：：CreateShaderCacheSession
• D3D12 著色器快取 API