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

Spécifie le mode préféré à utiliser lors de l'appel de [XDisplayTryEnableHdrMode](/fr/reference/system/xdisplay/functions/xdisplaytryenablehdrmode).

<a id="syntaxSection" />

## Syntaxe

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

<a id="constantsSection" />

## Constantes

| Constante | Description |
| - | - |
| PreferHdr | Le HDR est préféré à une fréquence d'actualisation plus élevée lorsque l'affichage ne prend pas en charge les deux simultanément. |
| PreferRefreshRate | La fréquence d'actualisation de 120 Hz est préférée au HDR lorsque l'affichage ne prend pas en charge les deux simultanément. |

<a id="remarksSection" />

## Remarques

Pour plus d'informations sur la prise en charge du HDR, consultez [Sortie HDR (High Dynamic Range) (rubrique sous NDA)](/fr/build/core-features/graphics/overviews/hdr-support).

Pour plus d'informations sur les valeurs de luminance HDR et le mappage de tons, consultez la présentation [For a Better HDR Gaming Experience](https://www.hgig.org/doc/ForBetterHDRGaming.pdf) sur le site web du HDR Gaming Interest Group.

**Exemple**

L'exemple de code suivant montre comment activer le mode HDR pour un affichage connecté. Si [XDisplayHdrModeInfo::Enabled](/fr/reference/system/xdisplay/enums/xdisplayhdrmoderesult) est retourné, le mode HDR est activé pour l'affichage, et le jeu peut choisir d'utiliser les valeurs de luminance de la structure `XDisplayHdrModeInfo` retournée pour optimiser l'image HDR rendue en fonction des capacités de l'affichage connecté. Sinon, le mode HDR est indisponible ou désactivé, et le jeu s'initialise en mode SDR (Standard Dynamic Range).

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

## Configuration requise

**En-tête :** XDisplay.h

**Plateformes prises en charge** : Windows, consoles de la famille XBOX One et consoles XBOX Series

<a id="seealsoSection" />

## Voir aussi

[XDisplayTryEnableHdrMode](/fr/reference/system/xdisplay/functions/xdisplaytryenablehdrmode)\
[XDisplay](/fr/reference/system/xdisplay/xdisplay_members)\
[Sortie HDR (High Dynamic Range) (rubrique sous NDA)](/fr/build/core-features/graphics/overviews/hdr-support)


## Related topics

- [XDisplayHdrModePreference](/reference/system/xdisplay/enums/xdisplayhdrmodepreference.md)
- [XDisplayTryEnableHdrMode](/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)