Поделиться через

структура 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

Для кэшей в памяти это единственное доступное хранилище. Для дисковых кэшей все сохраненные или найденные записи временно хранятся в памяти до тех пор, пока не будут исключены новыми записями. Это значение определяет размер этого временного хранилища. Значение по умолчанию — 1 КБ.

MaximumInMemoryCacheEntries

Тип: UINT

Указывает, сколько записей может храниться в памяти. По умолчанию — 128.

MaximumValueFileSizeBytes

Тип: UINT

Для дисковых кэшей определяет максимальный размер файла. Значение по умолчанию — 128 МБ.

Version

Тип: UINT64

Может использоваться для неявной очистки кэшей при обновлении приложения или компонента. Если версия не соответствует версии, хранящейся в кэше, она будет удалена и создана повторно.

Требования

Требование Значение
Минимальная версия клиента сборка Windows 10 20348
Минимальная версия сервера сборка Windows 10 20348
Верхняя часть d3d12.h

См. также раздел