> ## 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) 値 (nit 単位)。

*maxToneMapLuminance*\
型: float

最大トーン マップ輝度 (MaxTML) 値 (nit 単位)。

*maxFullFrameToneMapLuminance*\
型: float

最大フル フレーム トーン マップ輝度 (MaxFFTML) 値 (nit 単位)。

## Remarks

[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();
    }
}
```

## 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](/ja-jp/reference/system/xdisplay/enums/xdisplayhdrmoderesult.md)
- [XDisplayTryEnableHdrMode](/ja-jp/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)
- [XDisplayHdrModePreference](/ja-jp/reference/system/xdisplay/enums/xdisplayhdrmodepreference.md)
- [XDisplay](/ja-jp/reference/system/xdisplay/xdisplay_members.md)
- [XBOX 認定の概要](/ja-jp/publishing/certification/overview.md)