> ## 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 | ディスプレイが両方を同時にサポートしていない場合、HDR よりも 120 Hz のリフレッシュ レートを優先します。 |

<a id="remarksSection" />

## Remarks

HDR サポートの詳細については、[High Dynamic Range (HDR) output (NDA topic)](/build/core-features/graphics/overviews/hdr-support) を参照してください。

HDR 輝度値とトーン マッピングの詳細については、HDR Gaming Interest Group のウェブサイトにある [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)\
[High dynamic range (HDR) output (NDA topic)](/build/core-features/graphics/overviews/hdr-support)


## Related topics

- [XDisplayTryEnableHdrMode](/ja-jp/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)
- [XDisplay](/ja-jp/reference/system/xdisplay/xdisplay_members.md)
- [XDisplayHdrModeResult](/ja-jp/reference/system/xdisplay/enums/xdisplayhdrmoderesult.md)
- [XDisplayHdrModeInfo](/ja-jp/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)
- [XBOX 認定の概要](/ja-jp/publishing/certification/overview.md)