> ## 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) 值，以 nit 為單位。

*maxToneMapLuminance*\
類型：float

最大色調對應亮度 (MaxTML) 值，以 nit 為單位。

*maxFullFrameToneMapLuminance*\
類型：float

最大全畫面色調對應亮度 (MaxFFTML) 值，以 nit 為單位。

## 備註

[XDisplayTryEnableHdrMode](/zh-TW/reference/system/xdisplay/functions/xdisplaytryenablehdrmode) 函式會傳回 [XDisplayHdrModeResult](/zh-TW/reference/system/xdisplay/enums/xdisplayhdrmoderesult) 列舉值，指出函式是否能為連接的顯示器啟用 HDR 模式。如果傳回 **XDisplayHdrModeResult::Enabled**，函式也會提供 **XDisplayHdrModeInfo** 結構，其中包含顯示器 HDR 模式的相關資訊，包括 HDR 模式的最小和最大色調對應亮度值。

如需 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](/zh-TW/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](/zh-TW/reference/system/xdisplay/enums/xdisplayhdrmoderesult)\
[XDisplayTryEnableHdrMode](/zh-TW/reference/system/xdisplay/functions/xdisplaytryenablehdrmode)\
[XDisplay](/zh-TW/reference/system/xdisplay/xdisplay_members)


## Related topics

- [XDisplayHdrModeInfo](/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)
- [XDisplayHdrModeResult](/reference/system/xdisplay/enums/xdisplayhdrmoderesult.md)
- [XDisplayHdrModePreference](/reference/system/xdisplay/enums/xdisplayhdrmodepreference.md)