> ## 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（高动态范围）模式的最小和最大色调映射亮度值。

## Syntax

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

### Members

*minToneMapLuminance*\
类型：float

最小色调映射亮度 (MinTML) 值，以尼特为单位。

*maxToneMapLuminance*\
类型：float

最大色调映射亮度 (MaxTML) 值，以尼特为单位。

*maxFullFrameToneMapLuminance*\
类型：float

最大全帧色调映射亮度 (MaxFFTML) 值，以尼特为单位。

## Remarks

[XDisplayTryEnableHdrMode](/reference/system/xdisplay/functions/xdisplaytryenablehdrmode) 函数返回 [XDisplayHdrModeResult](/reference/system/xdisplay/enums/xdisplayhdrmoderesult) 枚举值，指示该函数是否可以为附加的显示器启用 HDR 模式。如果返回 **XDisplayHdrModeResult::Enabled**，该函数还会提供 **XDisplayHdrModeInfo** 结构，其中包含显示器 HDR 模式的信息，包括 HDR 模式的最小和最大色调映射亮度值。

有关 HDR 亮度值和色调映射的详细信息，请参阅 [HDR 游戏兴趣小组](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();
    }
}
```

## Requirements

**头文件：** XDisplay.h

**受支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## See also

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


## Related topics

- [XDisplayHdrModeResult](/zh-CN/reference/system/xdisplay/enums/xdisplayhdrmoderesult.md)
- [XDisplayTryEnableHdrMode](/zh-CN/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)
- [XDisplayHdrModePreference](/zh-CN/reference/system/xdisplay/enums/xdisplayhdrmodepreference.md)
- [XDisplay](/zh-CN/reference/system/xdisplay/xdisplay_members.md)
- [Screen Capture (wdcapture.exe)](/zh-CN/tools/tools-pc/commandlinetools/gr-wdCapture.md)