> ## 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" />

## Syntax

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

<a id="constantsSection" />

## Constants

| 常量                | 说明                               |
| ----------------- | -------------------------------- |
| PreferHdr         | 当显示器不能同时支持两者时，HDR 优先于更高的刷新率。     |
| PreferRefreshRate | 当显示器不能同时支持两者时，120 Hz 刷新率优先于 HDR。 |

<a id="remarksSection" />

## Remarks

有关 HDR 支持的详细信息，请参阅[高动态范围 (HDR) 输出（NDA 主题）](/build/core-features/graphics/overviews/hdr-support)。

有关 HDR 亮度值和色调映射的信息，请参阅 HDR 游戏兴趣小组网站上的 [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" />

## Requirements

**头文件：** XDisplay.h

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

<a id="seealsoSection" />

## See also

[XDisplayTryEnableHdrMode](/reference/system/xdisplay/functions/xdisplaytryenablehdrmode)\
[XDisplay](/reference/system/xdisplay/xdisplay_members)\
[高动态范围 (HDR) 输出（NDA 主题）](/build/core-features/graphics/overviews/hdr-support)


## Related topics

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