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 を参照してください。
- タイトルが HDR のみを実装しており、120hz をまったくサポートしていない場合。
- エンド ユーザーが 120Hz のリフレッシュ レートを望まないことをゲーム内設定で指定したか、パフォーマンスよりも品質を優先するなど、HDR を優先する場合。
- タイトルが 120Hz のリフレッシュ レートをサポートしていないゲーム モードにある場合。
- 120hz をサポートしており、開発者またはエンド ユーザーが、現在のシナリオではそれが優先されることを示している場合 (例: ゲーム内設定またはゲーム モードで パフォーマンスを優先 を設定する)。
- 優先設定に影響を与える何かが変化した場合。最もあり得るケースは、ユーザーがゲーム内設定を 品質を優先 から パフォーマンスを優先 に変更した場合です。
XDisplayTryEnableHdrMode を呼び出してフレームごとに切り替えないでください。特定の理由がある場合にのみ変更してください。
HDR 輝度値とトーン マッピングの詳細については、HDR Gaming Interest Group ウェブサイトにある For a Better HDR Gaming Experience プレゼンテーションを参照してください。
次の例は、接続されたディスプレイで HDR モードを有効にしようとします。XDisplayHdrModeInfo::Enabled が返された場合、そのディスプレイでは HDR モードが有効になっており、ゲームは返された XDisplayHdrModeInfo 構造体の輝度値を使用して HDR モードで初期化します。それ以外の場合、HDR モードは利用できないか、無効になっており、ゲームは SDR (標準ダイナミック レンジ) モードで初期化されます。
Requirements
ヘッダー: XDisplay.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: XBOX One ファミリー本体および XBOX Series 本体Conceptual documentation
See also
XDisplayHdrModePreferenceXDisplayHdrModeInfo
XDisplayHdrModeResult
XDisplay
