Skip to main content

XDisplayHdrModePreference

Specifies the preferred mode to use when calling XDisplayTryEnableHdrMode.

Syntax

Constants

Remarks

For more information about HDR support, see High Dynamic Range (HDR) output (NDA topic). For information about HDR luminance values and tone mapping, see the For a Better HDR Gaming Experience presentation on the HDR Gaming Interest Group website. Example The following code example demonstrates how to enable HDR mode for an attached display. If XDisplayHdrModeInfo::Enabled is returned, then HDR mode is enabled for the display, and the game can choose to use the luminance values from the returned XDisplayHdrModeInfo structure to optimize the rendered HDR image for the attached display’s capabilities. Otherwise, HDR mode is either unavailable, or it is disabled, and the game initializes in standard dynamic range (SDR) mode.

Requirements

Header: XDisplay.h Supported Platforms: Windows, XBOX One family consoles and XBOX Series consoles

See also

XDisplayTryEnableHdrMode
XDisplay
High dynamic range (HDR) output (NDA topic)
Last modified on August 20, 2026