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

Spécifie les valeurs de luminance minimale et maximale du mappage de tons pour le mode HDR (High Dynamic Range) sur l'affichage connecté.

## Syntaxe

```cpp theme={null}
typedef struct XDisplayHdrModeInfo {  
    float minToneMapLuminance;  
    float maxToneMapLuminance;  
    float maxFullFrameToneMapLuminance;  
} XDisplayHdrModeInfo  
```

### Membres

*minToneMapLuminance*\
Type : float

Valeur de luminance minimale du mappage de tons (MinTML), en nits.

*maxToneMapLuminance*\
Type : float

Valeur de luminance maximale du mappage de tons (MaxTML), en nits.

*maxFullFrameToneMapLuminance*\
Type : float

Valeur de luminance maximale du mappage de tons en plein cadre (MaxFFTML), en nits.

## Remarques

La fonction [XDisplayTryEnableHdrMode](/fr/reference/system/xdisplay/functions/xdisplaytryenablehdrmode) retourne une valeur d'énumération [XDisplayHdrModeResult](/fr/reference/system/xdisplay/enums/xdisplayhdrmoderesult) qui indique si la fonction peut activer le mode HDR pour l'affichage connecté. Si **XDisplayHdrModeResult::Enabled** est retourné, la fonction fournit également une structure **XDisplayHdrModeInfo** qui contient des informations sur le mode HDR de l'affichage, notamment les valeurs de luminance minimale et maximale du mappage de tons pour le mode HDR.

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](https://www.hgig.org/).

L'exemple suivant tente d'activer le mode HDR pour l'affichage connecté. Si [XDisplayHdrModeInfo::Enabled](/fr/reference/system/xdisplay/enums/xdisplayhdrmoderesult) est retourné, le mode HDR est activé pour l'affichage et le jeu utilise les valeurs de luminance de la structure **XDisplayHdrModeInfo** retournée pour s'initialiser en mode HDR ; 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();
    }
}
```

## Configuration requise

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

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

## Voir aussi

[XDisplayHdrModeResult](/fr/reference/system/xdisplay/enums/xdisplayhdrmoderesult)\
[XDisplayTryEnableHdrMode](/fr/reference/system/xdisplay/functions/xdisplaytryenablehdrmode)\
[XDisplay](/fr/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)