Freigeben über

D3D12_SHADER_CACHE_SESSION_DESC-Struktur (d3d12.h)

  • Artikel

Beschreibt eine Shadercachesitzung.

Syntax

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;

Member

Identifier

Typ: GUID

Ein eindeutiger Bezeichner, der diesem spezifischen Cache zugewiesen werden soll. Caches mit unterschiedlichen Bezeichnern werden nebeneinander gespeichert. Caches mit demselben Bezeichner werden für alle Sitzungen im selben Prozess freigegeben. Beim Erstellen eines Datenträgercaches mit demselben Bezeichner wie ein bereits vorhandener Cache wird dieser Cache geöffnet, es sei denn, die Version stimmt nicht überein. Wenn in diesem Fall keine anderen Sitzungen für diesen Cache geöffnet sind, wird er gelöscht und neu erstellt. Wenn Sitzungen vorhanden sind, gibt ID3D12Device9::CreateShaderCacheSessionDXGI_ERROR_ALREADY_EXISTS zurück.

Mode

Typ: D3D12_SHADER_CACHE_MODE

Gibt die Art des Caches an.

Flags

Typ: D3D12_SHADER_CACHE_FLAGS

Ändert das Verhalten des Caches.

MaximumInMemoryCacheSizeBytes

Typ: UINT

Für In-Memory-Caches ist dies der einzige verfügbare Speicher. Bei Datenträgercaches werden alle Einträge, die gespeichert oder gefunden werden, vorübergehend im Arbeitsspeicher gespeichert, bis sie von neueren Einträgen entfernt werden. Dieser Wert bestimmt die Größe dieses temporären Speichers. Der Standardwert ist 1 KB.

MaximumInMemoryCacheEntries

Typ: UINT

Gibt an, wie viele Einträge im Arbeitsspeicher gespeichert werden können. Der Standardwert ist 128.

MaximumValueFileSizeBytes

Typ: UINT

Steuert für Datenträgercaches die maximale Dateigröße. Der Standardwert ist 128 MB.

Version

Typ: UINT64

Kann verwendet werden, um Caches implizit zu löschen, wenn ein Anwendungs- oder Komponentenupdate abgeschlossen ist. Wenn die Version nicht mit der im Cache gespeicherten Version übereinstimmt, wird sie zurückgesetzt und neu erstellt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 Build 20348
Unterstützte Mindestversion (Server) Windows 10 Build 20348
Kopfzeile d3d12.h

Weitere Informationen