다음을 통해 공유

XDisplayHdrModePreference

  • 아티클

XDisplayTryEnableHdrMode를 호출할 때 사용할 기본 모드를 지정합니다.

구문

enum class XDisplayHdrModePreference  : uint32_t
{
    PreferHdr = 0,
    PreferRefreshRate = 1
}

상수

상수 설명
PreferHdr 디스플레이에서 HDR과 높은 새로 고침 빈도를 동시에 지원하지 않는 경우 높은 새로 고침 빈도보다 HDR이 선호됩니다.
PreferRefreshRate 디스플레이에서 HDR과 120Hz 새로 고침 빈도를 동시에 지원하지 않는 경우 HDR보다 120Hz 새로 고침 빈도가 선호됩니다.

설명

HDR 지원에 관한 자세한 내용은 HDR(High Dynamic Range) 출력(NDA 항목)을 참조하세요.

HDR 조도 값 및 톤 매핑에 대한 자세한 내용은 HDR Gaming Interest Group 웹 사이트의향상된 HDR 게이밍 환경 지원을 참조하세요.

예제

다음 코드 예제에서는 연결된 디스플레이에 대해 HDR 모드를 활성화하는 방법을 보여 줍니다. XDisplayHdrModeInfo::Enabled가 반환되면 디스플레이에 HDR 모드가 활성화되고, 게임에서 반환된 XDisplayHdrModeInfo 구조의 광도 값을 사용하여 연결된 디스플레이 기능에 대해 렌더링된 HDR 이미지를 최적화하도록 선택할 수 있습니다. 그렇지 않으면 HDR 모드를 사용할 수 없거나 사용하지 않도록 설정되고 게임이 표준 동적 범위(SDR) 모드로 초기화됩니다.

void Game::InitializeHDRMode() 
{
    // Attempt to enable HDR mode, then initialize based on the 
    // result of the attempt.
    XDisplayHdrModeInfo displayModeHdrInfo;

    if (XDisplayHdrModeResult::Enabled == XDisplayTryEnableHdrMode(XDisplayHdrModePreference::PreferHdr, &displayModeHdrInfo))
    {
        // HDR mode is enabled for the attached display.
        InitializeAsHDR(
            displayModeHdrInfo.minToneMapLuminance,
            displayModeHdrInfo.maxToneMapLuminance,
            displayModeHdrInfo.maxFullFrameToneMapLuminance);
    }
    else
    {
        // Either HDR mode is disabled for the attached display, or the
        // attached display does not support HDR.
        InitializeAsSDR();
    }
}

요구 사항

헤더: XDisplay.h

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XDisplayTryEnableHdrMode
XDisplay
HDR(High Dynamic Range) 출력(NDA 항목)