Skip to main content

XDisplayHdrModeInfo

指定連接之顯示器上 HDR (高動態範圍) 模式的最小和最大色調對應亮度值。

語法

成員

minToneMapLuminance
類型:float
最小色調對應亮度 (MinTML) 值,以 nit 為單位。 maxToneMapLuminance
類型:float
最大色調對應亮度 (MaxTML) 值,以 nit 為單位。 maxFullFrameToneMapLuminance
類型:float
最大全畫面色調對應亮度 (MaxFFTML) 值,以 nit 為單位。

備註

XDisplayTryEnableHdrMode 函式會傳回 XDisplayHdrModeResult 列舉值,指出函式是否能為連接的顯示器啟用 HDR 模式。如果傳回 XDisplayHdrModeResult::Enabled,函式也會提供 XDisplayHdrModeInfo 結構,其中包含顯示器 HDR 模式的相關資訊,包括 HDR 模式的最小和最大色調對應亮度值。 如需 HDR 亮度值和色調對應的詳細資訊,請參閱 HDR Gaming Interest Group 網站上的 For a Better HDR Gaming Experience 簡報。 下列範例會嘗試為連接的顯示器啟用 HDR 模式。如果傳回 XDisplayHdrModeInfo::Enabled,表示已為顯示器啟用 HDR 模式,遊戲會使用所傳回 XDisplayHdrModeInfo 結構中的亮度值以 HDR 模式初始化;否則,表示 HDR 模式無法使用或已停用,遊戲會以 SDR (標準動態範圍) 模式初始化。

需求

標頭: XDisplay.h 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

XDisplayHdrModeResult
XDisplayTryEnableHdrMode
XDisplay
Last modified on October 6, 2026