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

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](https://docs.xbox.com/es/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md) 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](https://docs.xbox.com/es/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md) 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](https://docs.xbox.com/es/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md) 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](https://docs.xbox.com/es/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)\
[XDisplayTryEnableHdrMode](https://docs.xbox.com/es/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)\
[XDisplay](https://docs.xbox.com/es/reference/system/xdisplay/xdisplay_members.md)


## Related topics

- [XDisplayTryEnableHdrMode](https://docs.xbox.com/es/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)
- [XDisplayHdrModeInfo](https://docs.xbox.com/es/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)
- [XDisplay (contenido de la API)](https://docs.xbox.com/es/reference/system/xdisplay/xdisplay_members.md)
- [XDisplayHdrModePreference](https://docs.xbox.com/es/reference/system/xdisplay/enums/xdisplayhdrmodepreference.md)
- [Captura de pantalla (wdcapture.exe)](https://docs.xbox.com/es/tools/tools-pc/commandlinetools/gr-wdCapture.md)