通过

XDisplayHdrModePreference

  • 项目

指定在调用 XDisplayTryEnableHdrMode 时的首选模式。

语法

enum class XDisplayHdrModePreference  : uint32_t
{
    PreferHdr = 0,
    PreferRefreshRate = 1
}

常量

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

备注

有关 HDR 支持的详细信息，请参阅高动态范围 (HDR) 输出（NDA 主题）。

有关 HDR 亮度值和色调映射的信息，请参阅 HDR 游戏兴趣小组网站上的获得更好的 HDR 游戏体验演示。

示例

下面的示例尝试为连接的显示屏启用 HDR 模式。 如果返回了 XDisplayHdrModeInfo::Enabled，那么显示器已启用了 HDR 模式，游戏可以选择使用来自返回的 XDisplayHdrModeInfo 结构的亮度值来优化呈现的 HDR 图像，以应用附加显示器的功能。 否则，要么 HDR 模式不可用，要么它被禁用，然后游戏会以标准动态范围 (SDR) 模式初始化。

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 主机

另请参阅

XDisplayTryEnableHdrMode
XDisplay
高动态范围 (HDR) 输出（NDA 主题）