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

# XDisplayHdrModePreference

> XDisplayHdrModePreference

# XDisplayHdrModePreference

[XDisplayTryEnableHdrMode](/reference/system/xdisplay/functions/xdisplaytryenablehdrmode)를 호출할 때 사용할 기본 모드를 지정합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
enum class XDisplayHdrModePreference  : uint32_t
{
    PreferHdr = 0,
    PreferRefreshRate = 1
}
```

<a id="constantsSection" />

## 상수

| 상수                | 설명                                                 |
| ----------------- | -------------------------------------------------- |
| PreferHdr         | 디스플레이가 두 가지를 동시에 지원하지 않을 때 더 높은 재생률보다 HDR을 선호합니다.  |
| PreferRefreshRate | 디스플레이가 두 가지를 동시에 지원하지 않을 때 HDR보다 120Hz 재생률을 선호합니다. |

<a id="remarksSection" />

## 설명

HDR 지원에 대한 자세한 내용은 [HDR(High Dynamic Range) 출력(NDA 항목)](/build/core-features/graphics/overviews/hdr-support)을 참조하세요.

HDR 휘도 값 및 톤 매핑에 대한 자세한 내용은 HDR Gaming Interest Group 웹 사이트에 있는 [For a Better HDR Gaming Experience](https://www.hgig.org/doc/ForBetterHDRGaming.pdf) 프레젠테이션을 참조하세요.

**예제**

다음 코드 예제는 연결된 디스플레이에 대해 HDR 모드를 활성화하는 방법을 보여 줍니다. [XDisplayHdrModeInfo::Enabled](/reference/system/xdisplay/enums/xdisplayhdrmoderesult)가 반환되면 디스플레이에 대해 HDR 모드가 활성화되며, 게임은 반환된 `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();
    }
}
```

<a id="requirementsSection" />

## 요구 사항

**헤더:** XDisplay.h

**지원 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

<a id="seealsoSection" />

## 함께 보기

[XDisplayTryEnableHdrMode](/reference/system/xdisplay/functions/xdisplaytryenablehdrmode)\
[XDisplay](/reference/system/xdisplay/xdisplay_members)\
[HDR(High Dynamic Range) 출력(NDA 항목)](/build/core-features/graphics/overviews/hdr-support)


## Related topics

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