> ## 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 los valores mínimo y máximo de luminancia de asignación de tonos para el modo HDR (alto rango dinámico) en la pantalla conectada.

## Sintaxis

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

### Miembros

*minToneMapLuminance*\
Tipo: float

El valor mínimo de luminancia de asignación de tonos (MinTML), en nits.

*maxToneMapLuminance*\
Tipo: float

El valor máximo de luminancia de asignación de tonos (MaxTML), en nits.

*maxFullFrameToneMapLuminance*\
Tipo: float

El valor máximo de luminancia de asignación de tonos de fotograma completo (MaxFFTML), en nits.

## Comentarios

La función [XDisplayTryEnableHdrMode](/reference/system/xdisplay/functions/xdisplaytryenablehdrmode) devuelve un valor de enumeración [XDisplayHdrModeResult](/reference/system/xdisplay/enums/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** que contiene información sobre el modo HDR para la pantalla, incluidos los valores mínimo y máximo de luminancia de asignación de tonos para el modo HDR.

Para obtener más información sobre los valores de luminancia de 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](https://www.hgig.org/).

El ejemplo siguiente intenta habilitar el modo HDR para la pantalla conectada. Si se devuelve [XDisplayHdrModeInfo::Enabled](/reference/system/xdisplay/enums/xdisplayhdrmoderesult), el modo HDR está habilitado para la pantalla y el juego usa los valores de luminancia de la estructura **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

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


## Related topics

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