> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/ko/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md) 함수는 연결된 디스플레이에 대해 HDR 모드를 활성화할 수 있는지를 나타내는 **XDisplayHdrModeResult** 열거형 값을 반환합니다. **XDisplayHdrModeResult::Enabled**가 반환되면, 함수는 HDR 모드의 최소 및 최대 톤 매핑 휘도 값을 포함하는 [XDisplayHdrModeInfo](https://docs.xbox.com/ko/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md) 구조체도 제공합니다.

다음 예제는 연결된 디스플레이에 대해 HDR 모드를 활성화하려고 시도합니다. **XDisplayHdrModeInfo::Enabled**가 반환되면 디스플레이에 대해 HDR 모드가 활성화되고 게임은 반환된 [XDisplayHdrModeInfo](https://docs.xbox.com/ko/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md) 구조체의 휘도 값을 사용하여 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](https://docs.xbox.com/ko/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)\
[XDisplayTryEnableHdrMode](https://docs.xbox.com/ko/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)\
[XDisplay](https://docs.xbox.com/ko/reference/system/xdisplay/xdisplay_members.md)


## Related topics

- [XDisplayTryEnableHdrMode](https://docs.xbox.com/ko/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)
- [XDisplayHdrModeInfo](https://docs.xbox.com/ko/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)
- [XDisplay (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xdisplay/xdisplay_members.md)
- [XDisplayHdrModePreference](https://docs.xbox.com/ko/reference/system/xdisplay/enums/xdisplayhdrmodepreference.md)
- [화면 캡처 (wdcapture.exe)](https://docs.xbox.com/ko/tools/tools-pc/commandlinetools/gr-wdCapture.md)