Skip to main content

XDisplayTryEnableHdrMode

接続されたディスプレイで HDR (ハイ ダイナミック レンジ) モードを有効にしようとします。

Syntax

Parameters

displayModePreference   _In_
型: XDisplayHdrModePreference
接続された TV が両方をサポートしていない場合に、HDR または最大 120Hz までの改善されたフレームレートのいずれかを優先するために使用される列挙型。 displayHdrModeInfo   _Out_opt_
型: XDisplayHdrModeInfo*
HDR モードが有効になっている場合、接続されたディスプレイの最小および最大トーン マップ輝度値。

Return value

型: XDisplayHdrModeResult 関数が成功した場合、戻り値は HDR モードが有効な場合は XDisplayHdrModeResult::Enabled に、HDR モードが有効でない場合は XDisplayHdrModeResult::Disabled に設定されます。関数が失敗した場合、戻り値は XDisplayHdrModeResult::Unknown に設定されます。

Remarks

この関数は、タイム センシティブ スレッドから呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
displayModePreference パラメーターは、両方を同時にサポートしていない TV に対して、HDR または 120Hz のリフレッシュ レートのいずれかを優先する手段を提供します。 以下の例では、開発者が現在のタイトルで HDR モードを有効にしようとし、より高いフレームレートよりも HDR を優先するように指定します (両方を同時に達成できない場合)。
タイトルは、次の場合に XDisplayHdrModePreference::PreferHdr を使用する必要があります:
  • タイトルが HDR のみを実装しており、120hz をまったくサポートしていない場合。
  • エンド ユーザーが 120Hz のリフレッシュ レートを望まないことをゲーム内設定で指定したか、パフォーマンスよりも品質を優先するなど、HDR を優先する場合。
  • タイトルが 120Hz のリフレッシュ レートをサポートしていないゲーム モードにある場合。
タイトルは、次の場合に XDisplayHdrModePreference::PreferRefreshRate を使用する必要があります:
  • 120hz をサポートしており、開発者またはエンド ユーザーが、現在のシナリオではそれが優先されることを示している場合 (例: ゲーム内設定またはゲーム モードで パフォーマンスを優先 を設定する)。
次の場合は、異なる優先設定で XDisplayTryEnableHdrMode を再度呼び出します:
  • 優先設定に影響を与える何かが変化した場合。最もあり得るケースは、ユーザーがゲーム内設定を 品質を優先 から パフォーマンスを優先 に変更した場合です。
XDisplayTryEnableHdrMode を呼び出してフレームごとに切り替えないでください。特定の理由がある場合にのみ変更してください。
XDisplayTryEnableHdrMode を呼び出した後、IDXGIOutput::GetDisplayModeList を呼び出して 120Hz のサポートを確認します。 XDisplayTryEnableHdrMode 関数は、接続されたディスプレイで HDR モードを有効にできるかどうかを示す XDisplayHdrModeResult 列挙値を返します。XDisplayHdrModeResult::Enabled が返される場合、関数は HDR モードの最小および最大トーン マップ輝度値を含む、ディスプレイの HDR モードに関する情報を含む XDisplayHdrModeInfo 構造体も提供します。既定では、HDR モードが有効な場合、XDisplayTryEnableHdrMode 関数は XDisplayHdrModeInfo のメンバーに対して次の値を返します: HDR 輝度値とトーン マッピングの詳細については、HDR Gaming Interest Group ウェブサイトにある For a Better HDR Gaming Experience プレゼンテーションを参照してください。 次の例は、接続されたディスプレイで HDR モードを有効にしようとします。XDisplayHdrModeInfo::Enabled が返された場合、そのディスプレイでは HDR モードが有効になっており、ゲームは返された XDisplayHdrModeInfo 構造体の輝度値を使用して HDR モードで初期化します。それ以外の場合、HDR モードは利用できないか、無効になっており、ゲームは SDR (標準ダイナミック レンジ) モードで初期化されます。
HDR サポートの詳細については、High dynamic range (HDR) output (NDA topic) を参照してください。

Requirements

ヘッダー: XDisplay.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

See also

XDisplayHdrModePreference
XDisplayHdrModeInfo
XDisplayHdrModeResult
XDisplay
最終更新日 2026年8月24日