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

# XDisplayHdrModePreference

> XDisplayHdrModePreference

# XDisplayHdrModePreference

Especifica el modo preferido que se usará al llamar a [XDisplayTryEnableHdrMode](https://docs.xbox.com/es/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md).

## Sintaxis

```cpp theme={null}
enum class XDisplayHdrModePreference  : uint32_t
{
    PreferHdr = 0,
    PreferRefreshRate = 1
}
```

## Constantes

| Constante | Descripción |
| - | - |
| PreferHdr | Se prefiere HDR frente a una frecuencia de actualización más alta cuando la pantalla no admite ambas simultáneamente. |
| PreferRefreshRate | Se prefiere una frecuencia de actualización de 120 Hz frente a HDR cuando la pantalla no admite ambas simultáneamente. |

## Comentarios

Para obtener más información sobre la compatibilidad con HDR, consulte [Salida de alto rango dinámico (HDR) (tema con NDA)](https://docs.xbox.com/es/build/core-features/graphics/overviews/hdr-support.md).

Para obtener información sobre los valores de luminancia HDR y la asignación de tonos, consulte la presentación [For a Better HDR Gaming Experience](https://www.hgig.org/doc/ForBetterHDRGaming.pdf) en el sitio web del HDR Gaming Interest Group.

**Ejemplo**

El siguiente ejemplo de código demuestra cómo habilitar el modo HDR para una pantalla conectada. Si se devuelve [XDisplayHdrModeInfo::Enabled](https://docs.xbox.com/es/reference/system/xdisplay/enums/xdisplayhdrmoderesult.md), el modo HDR está habilitado para la pantalla y el juego puede optar por usar los valores de luminancia de la estructura `XDisplayHdrModeInfo` devuelta para optimizar la imagen HDR representada según las capacidades de la pantalla conectada. De lo contrario, el modo HDR no está disponible o está deshabilitado, y el juego se inicializa en modo de rango dinámico estándar (SDR).

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

[XDisplayTryEnableHdrMode](https://docs.xbox.com/es/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)\
[XDisplay](https://docs.xbox.com/es/reference/system/xdisplay/xdisplay_members.md)\
[Salida de alto rango dinámico (HDR) (tema con NDA)](https://docs.xbox.com/es/build/core-features/graphics/overviews/hdr-support.md)


## Related topics

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