Skip to content

Latest commit

 

History

History
96 lines (69 loc) · 2.97 KB

ns-d3d12-d3d12_shader_cache_session_desc.md

File metadata and controls

96 lines (69 loc) · 2.97 KB
UID title description tech.root ms.date req.construct-type req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist f1_keywords dev_langs topic_type api_type api_location api_name
NS:d3d12.D3D12_SHADER_CACHE_SESSION_DESC
D3D12_SHADER_CACHE_SESSION_DESC
Describes a shader cache session.
direct3d12
08/09/2021
structure
d3d12.h
Windows
Windows 10 Build 20348
Windows 10 Build 20348
Windows
D3D12_SHADER_CACHE_SESSION_DESC
D3D12_SHADER_CACHE_SESSION_DESC
d3d12/D3D12_SHADER_CACHE_SESSION_DESC
c++
apiref
HeaderDef
d3d12.h
D3D12_SHADER_CACHE_SESSION_DESC

-description

Describes a shader cache session.

-struct-fields

-field Identifier

Type: GUID

A unique identifier to give to this specific cache. Caches with different identifiers are stored side by side. Caches with the same identifier are shared across all sessions in the same process. Creating a disk cache with the same identifier as an already-existing cache opens that cache, unless the Version doesn't matches. In that case, if there are no other sessions open to that cache, it is cleared and re-created. If there are existing sessions, then ID3D12Device9::CreateShaderCacheSession returns DXGI_ERROR_ALREADY_EXISTS.

-field Mode

Type: D3D12_SHADER_CACHE_MODE

Specifies the kind of cache.

-field Flags

Type: D3D12_SHADER_CACHE_FLAGS

Modifies the behavior of the cache.

-field MaximumInMemoryCacheSizeBytes

Type: UINT

For in-memory caches, this is the only storage available. For disk caches, all entries that are stored or found are temporarily stored in memory, until evicted by newer entries. This value determines the size of that temporary storage. Defaults to 1KB.

-field MaximumInMemoryCacheEntries

Type: UINT

Specifies how many entries can be stored in memory. Defaults to 128.

-field MaximumValueFileSizeBytes

Type: UINT

For disk caches, controls the maximum file size. Defaults to 128MB.

-field Version

Type: UINT64

Can be used to implicitly clear caches when an application or component update is done. If the version doesn't match the version stored in the cache, then it will be wiped and re-created.

-remarks

-see-also