> ## 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 o modo preferencial a ser usado ao chamar [XDisplayTryEnableHdrMode](https://docs.xbox.com/pt-BR/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md).

## Sintaxe

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

## Constantes

| Constante | Descrição |
| - | - |
| PreferHdr | O HDR é preferível a uma taxa de atualização maior quando a tela não oferece suporte a ambos simultaneamente. |
| PreferRefreshRate | A taxa de atualização de 120 Hz é preferível ao HDR quando a tela não oferece suporte a ambos simultaneamente. |

## Comentários

Para obter mais informações sobre o suporte a HDR, consulte [Saída HDR (High Dynamic Range) (tópico sob NDA)](https://docs.xbox.com/pt-BR/build/core-features/graphics/overviews/hdr-support.md).

Para obter informações sobre valores de luminância HDR e mapeamento de tons, consulte a apresentação [For a Better HDR Gaming Experience](https://www.hgig.org/doc/ForBetterHDRGaming.pdf) no site do HDR Gaming Interest Group.

**Exemplo**

O exemplo de código a seguir demonstra como habilitar o modo HDR para uma tela conectada. Se [XDisplayHdrModeInfo::Enabled](https://docs.xbox.com/pt-BR/reference/system/xdisplay/enums/xdisplayhdrmoderesult.md) for retornado, o modo HDR estará habilitado para a tela, e o jogo poderá optar por usar os valores de luminância da estrutura `XDisplayHdrModeInfo` retornada para otimizar a imagem HDR renderizada de acordo com as capacidades da tela conectada. Caso contrário, o modo HDR estará indisponível ou desabilitado, e o jogo será inicializado no modo 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();
    }
}
```

## Requisitos

**Cabeçalho:** XDisplay.h

**Plataformas com suporte**: Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[XDisplayTryEnableHdrMode](https://docs.xbox.com/pt-BR/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)\
[XDisplay](https://docs.xbox.com/pt-BR/reference/system/xdisplay/xdisplay_members.md)\
[Saída HDR (High Dynamic Range) (tópico sob NDA)](https://docs.xbox.com/pt-BR/build/core-features/graphics/overviews/hdr-support.md)


## Related topics

- [XDisplayTryEnableHdrMode](https://docs.xbox.com/pt-BR/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)
- [XDisplay (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xdisplay/xdisplay_members.md)
- [XDisplayHdrModeResult](https://docs.xbox.com/pt-BR/reference/system/xdisplay/enums/xdisplayhdrmoderesult.md)
- [XDisplayHdrModeInfo](https://docs.xbox.com/pt-BR/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)
- [Captura de tela (wdcapture.exe)](https://docs.xbox.com/pt-BR/tools/tools-pc/commandlinetools/gr-wdCapture.md)