> ## 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.

# XDisplayHdrModeResult

> XDisplayHdrModeResult

# XDisplayHdrModeResult

연결된 디스플레이의 HDR(하이 다이내믹 레인지) 지원 현재 상태를 지정합니다.

## 구문

```cpp theme={null}
enum class XDisplayHdrModeResult  : uint32_t  
{  
    Unknown = 0,  
    Enabled = 1,  
    Disabled = 2  
}  
```

## 상수

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

## 설명

[XDisplayTryEnableHdrMode](/reference/system/xdisplay/functions/xdisplaytryenablehdrmode) 함수는 연결된 디스플레이에 대해 HDR 모드를 활성화할 수 있는지를 나타내는 **XDisplayHdrModeResult** 열거형 값을 반환합니다. **XDisplayHdrModeResult::Enabled**가 반환되면, 함수는 HDR 모드의 최소 및 최대 톤 매핑 휘도 값을 포함하는 [XDisplayHdrModeInfo](/reference/system/xdisplay/structs/xdisplayhdrmodeinfo) 구조체도 제공합니다.

다음 예제는 연결된 디스플레이에 대해 HDR 모드를 활성화하려고 시도합니다. **XDisplayHdrModeInfo::Enabled**가 반환되면 디스플레이에 대해 HDR 모드가 활성화되고 게임은 반환된 [XDisplayHdrModeInfo](/reference/system/xdisplay/structs/xdisplayhdrmodeinfo) 구조체의 휘도 값을 사용하여 HDR 모드로 초기화됩니다. 그렇지 않으면 HDR 모드를 사용할 수 없거나 비활성화된 상태이며, 게임은 SDR(표준 동적 범위) 모드로 초기화됩니다.

```cpp theme={null}
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](/reference/system/xdisplay/structs/xdisplayhdrmodeinfo)\
[XDisplayTryEnableHdrMode](/reference/system/xdisplay/functions/xdisplaytryenablehdrmode)\
[XDisplay](/reference/system/xdisplay/xdisplay_members)


## Related topics

- [XDisplayTryEnableHdrMode](/ko/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)
- [XDisplayHdrModeInfo](/ko/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)
- [XDisplay](/ko/reference/system/xdisplay/xdisplay_members.md)
- [XDisplayHdrModePreference](/ko/reference/system/xdisplay/enums/xdisplayhdrmodepreference.md)
- [XBOX 인증 개요](/ko/publishing/certification/overview.md)