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

# XDisplayHdrModeInfo

> XDisplayHdrModeInfo

# XDisplayHdrModeInfo

연결된 디스플레이에서 HDR(하이 다이내믹 레인지) 모드에 대한 최소 및 최대 톤 매핑 휘도 값을 지정합니다.

## 구문

```cpp theme={null}
typedef struct XDisplayHdrModeInfo {  
    float minToneMapLuminance;  
    float maxToneMapLuminance;  
    float maxFullFrameToneMapLuminance;  
} XDisplayHdrModeInfo  
```

### 멤버

*minToneMapLuminance*\
형식: float

최소 톤 매핑 휘도(MinTML) 값(니트).

*maxToneMapLuminance*\
형식: float

최대 톤 매핑 휘도(MaxTML) 값(니트).

*maxFullFrameToneMapLuminance*\
형식: float

최대 풀 프레임 톤 매핑 휘도(MaxFFTML) 값(니트).

## 설명

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

HDR 휘도 값 및 톤 매핑에 대한 자세한 내용은 [HDR Gaming Interest Group](https://www.hgig.org/) 웹 사이트의 [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();
    }
}
```

## 요구 사항

**헤더:** XDisplay.h

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

## 함께 보기

[XDisplayHdrModeResult](/reference/system/xdisplay/enums/xdisplayhdrmoderesult)\
[XDisplayTryEnableHdrMode](/reference/system/xdisplay/functions/xdisplaytryenablehdrmode)\
[XDisplay](/reference/system/xdisplay/xdisplay_members)


## Related topics

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