> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_SHADER_CACHE_SESSION_DESC

> 셰이더 캐시 세션을 설명합니다.

셰이더 캐시 세션을 설명합니다.

## 구문

```cpp theme={null}
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

이 특정 캐시에 부여할 고유 식별자입니다. 서로 다른 식별자를 가진 캐시는 나란히 저장됩니다. 동일한 식별자를 가진 캐시는 동일한 프로세스 내 모든 세션에서 공유됩니다. 이미 존재하는 캐시와 동일한 식별자로 디스크 캐시를 만들면 해당 캐시가 열립니다. 단 **Version**이 일치하지 않는 경우는 예외입니다. 이 경우 해당 캐시에 열려 있는 다른 세션이 없으면 지워지고 다시 만들어집니다. 기존 세션이 있다면 [ID3D12Device9::CreateShaderCacheSession](/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createshadercachesession_public)이 **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

애플리케이션 또는 구성 요소 업데이트가 완료될 때 캐시를 암시적으로 지우는 데 사용할 수 있습니다. 버전이 캐시에 저장된 버전과 일치하지 않으면 지워지고 다시 만들어집니다.

## 설명

## 요구 사항

**헤더:** d3d12\_xs.h 또는 d3d12\_x.h\
**라이브러리:** d3d12\_xs.lib 또는 d3d12\_x.lib\
**지원 플랫폼**: XBOX Series 콘솔 및 XBOX One 제품군

## 함께 보기

* [ID3D12Device9::CreateShaderCacheSession](/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createshadercachesession_public)
* [D3D12 셰이더 캐시 API](https://microsoft.github.io/DirectX-Specs/d3d/ShaderCache.html)


## Related topics

- [ID3D12ShaderCacheSession::GetDesc](/ko/reference/graphics/d3d12/interfaces/id3d12shadercachesession/methods/id3d12shadercachesession_getdesc_public.md)
- [D3D12_SHADER_CACHE_FLAGS](/ko/reference/graphics/d3d12/enums/d3d12_shader_cache_flags_public.md)
- [CreateShaderCacheSession (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createshadercachesession_public.md)
- [D3D12_SHADER_CACHE_MODE](/ko/reference/graphics/d3d12/enums/d3d12_shader_cache_mode_public.md)
- [ID3D12ShaderCacheSession](/ko/reference/graphics/d3d12/interfaces/id3d12shadercachesession/id3d12shadercachesession_public.md)