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

# XDisplayHdrModeResult

> XDisplayHdrModeResult

# XDisplayHdrModeResult

Especifica el estado actual de la compatibilidad con HDR (alto rango dinámico) en la pantalla conectada.

## Sintaxis

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

## Constantes

| Constante | Descripción                                                                         |
| --------- | ----------------------------------------------------------------------------------- |
| Unknown   | Se produjo un error y el estado actual de la compatibilidad con HDR es desconocido. |
| Enabled   | El modo HDR está habilitado.                                                        |
| Disabled  | El modo HDR está deshabilitado.                                                     |

## Comentarios

La función [XDisplayTryEnableHdrMode](/reference/system/xdisplay/functions/xdisplaytryenablehdrmode) devuelve un valor de la enumeración **XDisplayHdrModeResult** que indica si la función puede habilitar el modo HDR para la pantalla conectada. Si se devuelve **XDisplayHdrModeResult::Enabled**, la función también proporciona una estructura [XDisplayHdrModeInfo](/reference/system/xdisplay/structs/xdisplayhdrmodeinfo) que contiene los valores mínimo y máximo de luminancia de asignación de tonos para el modo HDR.

El siguiente ejemplo intenta habilitar el modo HDR para la pantalla conectada. Si se devuelve **XDisplayHdrModeInfo::Enabled**, el modo HDR está habilitado para la pantalla y el juego usa los valores de luminancia de la estructura [XDisplayHdrModeInfo](/reference/system/xdisplay/structs/xdisplayhdrmodeinfo) devuelta para inicializarse en modo HDR; de lo contrario, el modo HDR no está disponible o está deshabilitado, y el juego se inicializa en modo SDR (rango dinámico estándar).

```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();
    }
}
```

## Requisitos

**Encabezado:** XDisplay.h

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[XDisplayHdrModeInfo](/reference/system/xdisplay/structs/xdisplayhdrmodeinfo)\
[XDisplayTryEnableHdrMode](/reference/system/xdisplay/functions/xdisplaytryenablehdrmode)\
[XDisplay](/reference/system/xdisplay/xdisplay_members)


## Related topics

- [XDisplayTryEnableHdrMode](/es/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)
- [XDisplayHdrModeInfo](/es/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)
- [XDisplay](/es/reference/system/xdisplay/xdisplay_members.md)
- [XDisplayHdrModePreference](/es/reference/system/xdisplay/enums/xdisplayhdrmodepreference.md)
- [FMA XR-131: Modo de visualización para Game DVR y capturas de pantalla](/es/publishing/certification/fma/xr-131.md)