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

# XDisplayHdrModeInfo

> XDisplayHdrModeInfo

# XDisplayHdrModeInfo

Especifica os valores mínimo e máximo de luminância do mapeamento de tons para o modo HDR (High Dynamic Range) na tela conectada.

## Sintaxe

```cpp theme={null}
typedef struct XDisplayHdrModeInfo {  
    float minToneMapLuminance;  
    float maxToneMapLuminance;  
    float maxFullFrameToneMapLuminance;  
} XDisplayHdrModeInfo  
```

### Membros

*minToneMapLuminance*\
Tipo: float

O valor mínimo de luminância do mapeamento de tons (MinTML), em nits.

*maxToneMapLuminance*\
Tipo: float

O valor máximo de luminância do mapeamento de tons (MaxTML), em nits.

*maxFullFrameToneMapLuminance*\
Tipo: float

O valor máximo de luminância do mapeamento de tons de quadro completo (MaxFFTML), em nits.

## Comentários

A função [XDisplayTryEnableHdrMode](/pt-BR/reference/system/xdisplay/functions/xdisplaytryenablehdrmode) retorna um valor de enumeração [XDisplayHdrModeResult](/pt-BR/reference/system/xdisplay/enums/xdisplayhdrmoderesult) que indica se a função pode habilitar o modo HDR para a tela conectada. Se **XDisplayHdrModeResult::Enabled** for retornado, a função também fornecerá uma estrutura **XDisplayHdrModeInfo** que contém informações sobre o modo HDR da tela, incluindo os valores mínimo e máximo de luminância do mapeamento de tons para o modo HDR.

Para obter mais 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](https://www.hgig.org/).

O exemplo a seguir tenta habilitar o modo HDR para a tela conectada. Se [XDisplayHdrModeInfo::Enabled](/pt-BR/reference/system/xdisplay/enums/xdisplayhdrmoderesult) for retornado, o modo HDR estará habilitado para a tela, e o jogo usará os valores de luminância da estrutura **XDisplayHdrModeInfo** retornada para inicializar no modo HDR; 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

[XDisplayHdrModeResult](/pt-BR/reference/system/xdisplay/enums/xdisplayhdrmoderesult)\
[XDisplayTryEnableHdrMode](/pt-BR/reference/system/xdisplay/functions/xdisplaytryenablehdrmode)\
[XDisplay](/pt-BR/reference/system/xdisplay/xdisplay_members)


## Related topics

- [XDisplayHdrModeResult](/pt-BR/reference/system/xdisplay/enums/xdisplayhdrmoderesult.md)
- [XDisplayHdrModePreference](/pt-BR/reference/system/xdisplay/enums/xdisplayhdrmodepreference.md)
- [XDisplayTryEnableHdrMode](/pt-BR/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)
- [XDisplay](/pt-BR/reference/system/xdisplay/xdisplay_members.md)
- [Captura de tela (wdcapture.exe)](/pt-BR/tools/tools-pc/commandlinetools/gr-wdCapture.md)