XDisplayTryEnableHdrMode
연결된 디스플레이에 대해 HDR(하이 다이내믹 레인지) 모드를 활성화하려고 시도합니다.구문
매개 변수
displayModePreference _In_형식: XDisplayHdrModePreference 연결된 TV에서 두 가지를 동시에 지원하지 않는 경우 HDR 또는 최대 120Hz의 향상된 프레임률 중 어느 쪽을 선호할지를 지정하는 데 사용되는 열거형입니다. displayHdrModeInfo _Out_opt_
형식: XDisplayHdrModeInfo* HDR 모드가 활성화된 경우, 연결된 디스플레이의 최소 및 최대 톤 매핑 휘도 값입니다.
반환 값
형식: XDisplayHdrModeResult 함수가 성공하면 반환 값은 HDR 모드가 활성화된 경우 XDisplayHdrModeResult::Enabled, HDR 모드가 활성화되지 않은 경우 XDisplayHdrModeResult::Disabled로 설정됩니다. 함수가 실패하면 반환 값은 XDisplayHdrModeResult::Unknown으로 설정됩니다.설명
이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
- 타이틀이 HDR만 구현하고 120Hz를 전혀 지원하지 않는 경우.
- 최종 사용자가 게임 내 설정에서 120Hz 재생률을 원하지 않는다고 지정했거나, 성능보다 품질을 선호하는 등 HDR을 선호하는 경우.
- 타이틀이 120Hz 재생률을 지원하지 않는 게임 모드에 있는 경우.
- 120Hz를 지원하며, 개발자 또는 최종 사용자가 현재 시나리오에서 이를 선호한다고 지정한 경우(예: 게임 내 설정 또는 게임 모드에서 성능 우선 설정).
- 기본 설정에 영향을 미치는 무언가가 변경된 경우. 가장 흔한 예는 사용자가 게임 내 설정을 품질 우선에서 성능 우선으로 변경한 경우입니다.
매 프레임마다 XDisplayTryEnableHdrMode를 호출하고 앞뒤로 전환하지 마세요. 특정 계기가 있을 때만 변경하세요.
HDR 휘도 값 및 톤 매핑에 대한 자세한 내용은 HDR Gaming Interest Group 웹 사이트의 For a Better HDR Gaming Experience 프레젠테이션을 참조하세요.
다음 예제는 연결된 디스플레이에 대해 HDR 모드를 활성화하려고 시도합니다. XDisplayHdrModeInfo::Enabled가 반환되면 디스플레이에 대해 HDR 모드가 활성화되고 게임은 반환된 XDisplayHdrModeInfo 구조체의 휘도 값을 사용하여 HDR 모드로 초기화됩니다. 그렇지 않으면 HDR 모드를 사용할 수 없거나 비활성화된 상태이며, 게임은 SDR(표준 동적 범위) 모드로 초기화됩니다.
요구 사항
헤더: XDisplay.h 라이브러리: xgameruntime.lib 지원 플랫폼: XBOX One 계열 콘솔 및 XBOX Series 콘솔개념 문서
함께 보기
XDisplayHdrModePreferenceXDisplayHdrModeInfo
XDisplayHdrModeResult
XDisplay
