> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XDisplayHdrModeResult

> XDisplayHdrModeResult

# XDisplayHdrModeResult

Spécifie l'état actuel de la prise en charge du HDR (High Dynamic Range) sur l'affichage connecté.

## Syntaxe

```cpp theme={null}
enum class XDisplayHdrModeResult  : uint32_t  
{  
    Unknown = 0,  
    Enabled = 1,  
    Disabled = 2  
}  
```

## Constantes

| Constante | Description |
| - | - |
| Unknown | Une erreur s'est produite, et l'état actuel de la prise en charge du HDR est inconnu. |
| Enabled | Le mode HDR est activé. |
| Disabled | Le mode HDR est désactivé. |

## Remarques

La fonction [XDisplayTryEnableHdrMode](https://docs.xbox.com/fr/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md) retourne une valeur d'énumération **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](https://docs.xbox.com/fr/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md) qui contient les valeurs de luminance minimale et maximale du mappage de tons pour le mode HDR.

L'exemple suivant tente d'activer le mode HDR pour l'affichage connecté. Si **XDisplayHdrModeInfo::Enabled** est retourné, le mode HDR est activé pour l'affichage et le jeu utilise les valeurs de luminance de la structure [XDisplayHdrModeInfo](https://docs.xbox.com/fr/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md) 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

[XDisplayHdrModeInfo](https://docs.xbox.com/fr/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)\
[XDisplayTryEnableHdrMode](https://docs.xbox.com/fr/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)\
[XDisplay](https://docs.xbox.com/fr/reference/system/xdisplay/xdisplay_members.md)


## Related topics

- [XDisplayTryEnableHdrMode](https://docs.xbox.com/fr/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)
- [XDisplayHdrModeInfo](https://docs.xbox.com/fr/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)
- [XDisplay (contenu de l'API)](https://docs.xbox.com/fr/reference/system/xdisplay/xdisplay_members.md)
- [XDisplayHdrModePreference](https://docs.xbox.com/fr/reference/system/xdisplay/enums/xdisplayhdrmodepreference.md)
- [Capture d'écran (wdcapture.exe)](https://docs.xbox.com/fr/tools/tools-pc/commandlinetools/gr-wdCapture.md)