> ## 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 minimale et maximale de luminance de mappage de tons pour le mode HDR (High Dynamic Range) sur l'écran connecté.

## Syntaxe

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

### Membres

*minToneMapLuminance*\
Type : float

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

*maxToneMapLuminance*\
Type : float

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

*maxFullFrameToneMapLuminance*\
Type : float

Valeur maximale de luminance de mappage de tons plein écran (MaxFFTML), en nits.

## Remarques

La fonction [XDisplayTryEnableHdrMode](/fr-CA/reference/system/xdisplay/functions/xdisplaytryenablehdrmode) retourne une valeur d'énumération [XDisplayHdrModeResult](/fr-CA/reference/system/xdisplay/enums/xdisplayhdrmoderesult) qui indique si la fonction peut activer le mode HDR pour l'écran connecté. Si **XDisplayHdrModeResult::Enabled** est retourné, la fonction fournit également une structure **XDisplayHdrModeInfo** qui contient des informations sur le mode HDR de l'écran, notamment les valeurs minimale et maximale de luminance de 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'écran connecté. Si [XDisplayHdrModeInfo::Enabled](/fr-CA/reference/system/xdisplay/enums/xdisplayhdrmoderesult) est retourné, le mode HDR est activé pour l'écran et le jeu utilise les valeurs de luminance de la structure **XDisplayHdrModeInfo** retournée pour s'initialiser en mode HDR; sinon, le mode HDR n'est pas disponible ou est 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-CA/reference/system/xdisplay/enums/xdisplayhdrmoderesult)\
[XDisplayTryEnableHdrMode](/fr-CA/reference/system/xdisplay/functions/xdisplaytryenablehdrmode)\
[XDisplay](/fr-CA/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)