다음을 통해 공유

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

추가 정보