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

另请参阅