XDisplayHdrModeResult

연결된 디스플레이에서 HDR(High Dynamic Range) 지원에 대한 현재 상태를 지정합니다.

구문

enum class XDisplayHdrModeResult  : uint32_t  
{  
    Unknown = 0,  
    Enabled = 1,  
    Disabled = 2  
}  

상수

상수	설명
Unknown	오류가 발생했으며, HDR 지원의 현재 상태를 알 수 없습니다.
Enabled	HDR 모드가 활성화되어 있습니다.
Disabled	HDR 모드가 비활성화되어 있습니다.

비고

XDisplayTryEnableHdrMode 함수는 이 함수가 연결된 디스플레이에 대해 HDR 모드를 활성화할 수 있는지 여부를 나타내는 XDisplayHdrModeResult 열거형 값을 반환합니다. XDisplayHdrModeResult::Enabled가 반환된 경우, 이 함수는 또한 HDR 모드에 대한 최소 및 최대 톤 맵 조도 값이 포함된 XDisplayHdrModeInfo 구조를 제공합니다.

다음 예에서는 연결된 디스플레이에 대해 HDR 모드를 활성화하려고 시도합니다. XDisplayHdrModeInfo::Enabled가 반환된 경우 HDR 모드가 디스플레이에 대해 활성화되고, 게임이 반환된 XDisplayHdrModeInfo 구조의 조도 값을 사용하여 HDR 모드로 초기화됩니다. 그렇지 않으면 HDR 모드가 제공되지 않았거나 비활성화된 것이고, 게임이 SDR(Standard Dynamic Range) 모드로 초기화됩니다.

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 콘솔

참고 항목

XDisplayHdrModeInfo
XDisplayTryEnableHdrMode
XDisplay