XDisplayTryEnableHdrMode

Tente d’activer le mode HDR (High Dynamic Range) pour l’affichage connecté.

Syntaxe

XDisplayHdrModeResult XDisplayTryEnableHdrMode(  
         XDisplayHdrModePreference displayModePreference,  
         XDisplayHdrModeInfo* displayHdrModeInfo  
)  

Paramètres

displayModePreference _In_
Type : XDisplayHdrModePreference Énumération utilisée pour privilégier soit le HDR, soit une fréquence d’images améliorée jusqu’à 120 Hz, lorsque le téléviseur connecté ne prend pas en charge les deux. displayHdrModeInfo _Out_opt_
Type : XDisplayHdrModeInfo* Si le mode HDR est activé, valeurs de luminance minimale et maximale du mappage de tons pour l’affichage connecté.

Valeur de retour

Type : XDisplayHdrModeResult Si la fonction réussit, la valeur de retour est définie sur XDisplayHdrModeResult::Enabled si le mode HDR est activé, ou sur XDisplayHdrModeResult::Disabled si le mode HDR n’est pas activé. Si la fonction échoue, la valeur de retour est définie sur XDisplayHdrModeResult::Unknown.

Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread soumis à des contraintes de temps. Pour plus d’informations, consultez Threads soumis à des contraintes de temps.

Le paramètre displayModePreference permet de privilégier le HDR ou les fréquences d’actualisation de 120 Hz pour les téléviseurs qui ne prennent pas en charge les deux simultanément. Dans l’exemple ci-dessous, le développeur tente d’activer le mode HDR pour le titre actuel, en indiquant une préférence pour le HDR plutôt qu’une fréquence d’images plus élevée (dans le cas où les deux ne peuvent pas être obtenus).

const XDisplayHdrModeResult result = XDisplayTryEnableHdrMode( 
    XDisplayHdrModePreference::PreferHdr, 
    &displayModeHdrInfo); 

switch (result) 
{ 
  case XDisplayHdrModeResult::Unknown: 
    // HDR is currently in an unknown state. 
    break; 
  case XDisplayHdrModeResult::Enabled: 
    // HDR is currently enabled. 
    break; 
  case XDisplayHdrModeResult::Disabled: 
    // HDR is currently disabled. 
    break; 
}

Les titres doivent utiliser XDisplayHdrModePreference::PreferHdr dans les cas suivants :

Votre titre implémente uniquement le HDR et ne prend pas du tout en charge le 120 Hz.
L’utilisateur final a défini un paramètre dans le jeu indiquant qu’il ne souhaite pas de fréquence d’actualisation de 120 Hz, ou qu’il préfère le HDR, par exemple une préférence pour la qualité plutôt que pour les performances.
Le titre se trouve dans un mode de jeu dans lequel la fréquence d’actualisation de 120 Hz n’est pas prise en charge.

Les titres doivent utiliser XDisplayHdrModePreference::PreferRefreshRate dans le cas suivant :

Vous prenez en charge le 120 Hz et vous ou l’utilisateur final avez indiqué qu’il est préféré pour le scénario actuel (par exemple, en définissant Privilégier les performances dans un paramètre ou un mode de jeu).

Appelez XDisplayTryEnableHdrMode une deuxième fois avec une préférence différente dans le cas suivant :

Un changement a modifié votre préférence. Le plus souvent, l’utilisateur a modifié le paramètre dans le jeu, passant de Privilégier la qualité à Privilégier les performances.

N’appelez pas XDisplayTryEnableHdrMode en basculant d’un mode à l’autre à chaque image ; n’effectuez de changement qu’en présence d’un déclencheur spécifique.

Après avoir appelé XDisplayTryEnableHdrMode, appelez IDXGIOutput::GetDisplayModeList pour vérifier la prise en charge du 120 Hz. La fonction XDisplayTryEnableHdrMode retourne une valeur d’énumération XDisplayHdrModeResult qui indique si la fonction peut activer le mode HDR pour l’affichage connecté. Si XDisplayHdrModeResult::Enabled est retourné, la fonction fournit également une structure XDisplayHdrModeInfo qui contient des informations sur le mode HDR de l’affichage, notamment les valeurs de luminance minimale et maximale du mappage de tons pour le mode HDR. Par défaut, si le mode HDR est activé, la fonction XDisplayTryEnableHdrMode retourne les valeurs suivantes pour les membres de XDisplayHdrModeInfo :

Membre	Valeur
minToneMapLuminance	0.01
maxToneMapLuminance	1000
maxFullFrameToneMapLuminance	1000

Pour plus d’informations sur les valeurs de luminance HDR et le mappage de tons, consultez la présentation For a Better HDR Gaming Experience sur le site web du HDR Gaming Interest Group. L’exemple suivant tente d’activer le mode HDR pour l’affichage connecté. Si XDisplayHdrModeInfo::Enabled est retourné, le mode HDR est activé pour l’affichage et le jeu utilise les valeurs de luminance de la structure XDisplayHdrModeInfo retournée pour s’initialiser en mode HDR ; sinon, le mode HDR est indisponible ou désactivé, et le jeu s’initialise en mode SDR (Standard Dynamic Range).

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();
    }
}

Pour plus d’informations sur la prise en charge du HDR, consultez Sortie HDR (High Dynamic Range) (rubrique sous NDA).

Configuration requise

En-tête : XDisplay.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Threads soumis à des contraintes de temps

Voir aussi

XDisplayHdrModePreference
XDisplayHdrModeInfo
XDisplayHdrModeResult
XDisplay

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

XDisplayTryEnableHdrMode

XDisplayTryEnableHdrMode

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi

​XDisplayTryEnableHdrMode

​Syntaxe

​Paramètres

​Valeur de retour

​Remarques

​Configuration requise

​Documentation conceptuelle

​Voir aussi

XDisplayTryEnableHdrMode

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi