IddCxAdapterDisplayConfigUpdate2 関数 (iddcx.h)

リモート ドライバーは、IddCxAdapterDisplayConfigUpdate2 呼び出して、クライアントがサーバーにモニター構成の更新方法を指示できるようにします。

構文

HRESULT IddCxAdapterDisplayConfigUpdate2(
  IDDCX_ADAPTER                              AdapterObject,
  const IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 *pInArgs
);

パラメーター

AdapterObject

[in]表示構成が指定されているリモート アダプターの IDDCX_ADAPTER オブジェクト。

pInArgs

[in]関数への入力引数を含む IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 構造体へのポインター。

戻り値

iddCxAdapterDisplayConfigUpdate2 成功するとSTATUS_SUCCESSが返されます。それ以外の場合は、適切なエラー コードが返されます。

備考

リモート間接ディスプレイ ドライバーは、iddCxAdapterDisplayConfigUpdate2 呼び出して、OS が特定のモニターに使用するモード、色測定、およびその他の値を設定できます。 この関数を呼び出すことができるのはリモート ドライバーだけです。

HDR サポートの詳細については、iddCx バージョン 1.10 更新プログラム を参照してください。

IDDCX_DISPLAYCONFIGPATH2 構造体は、すべての情報をすべての呼び出しで提供する必要がないように定義されます。 たとえば、カラー モードが HDR または WCG でない場合は一部のパスで測色データが提供されない場合や、レイアウトの変更が必要ない場合にのみ SDR ホワイト レベルを更新するために IddCxAdapterDisplayConfigUpdate2 を呼び出すことができる場合があります。

モードの制御 (パスの IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID フラグの設定) には、いくつかの追加の規則と説明があります。

• いずれかのパス IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID 設定されている場合は、指定されたすべてのパスに設定する必要があります
• すべてのパスで IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID が指定されている場合、パス リストにない現在アクティブなパスは非アクティブになります
• IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID 以外のフラグのみが設定されている場合は、更新するパスのみが存在する必要があります
• 指定されたカラー モードによっては、パスに追加のデータが必要になる場合があります。 次の表は、設定する必要がある追加フラグを示しています。

カラー モード	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID
SDR	いいえ	いいえ
SDRWCG	はい	いいえ
HDR	はい	はい

IddCxAdapterDisplayConfigUpdate2 の最初の呼び出しと後続の呼び出し

IddCxAdapterDisplayConfigUpdate2 呼び出しにパスが初めて含まれる場合、以降の呼び出しの要件は異なります。 次の表に、要件の概要を示します。

パス フィールド	パスの最初の呼び出しで必須	最初の呼び出し後に更新できます	Windows クライアントが情報を取得する方法
モード	はい	はい	QueryDisplayConfig はクライアントの表示構成を提供し、表示構成の変更時に WM_DISPLAYCHANGE が送信されます。AdvancedColorInfo.CurrentAdvancedColorKind はカラー モードを提供します
尺度	はい	はい	ドライバーは、IddCxAdapterDisplayConfigUpdate に使用されるメソッドを使用
物理サイズ	EDID が渡されない場合ははい	いいえ	EDID が渡された場合は不要
測 色	はい (SDR 以外のカラー モードの場合)	はい	対応する AdvancedColorInfo フィールドのほとんどのフィールド
SDR ホワイト レベル	HDR カラー モードの場合ははい。既定値は 80 ニトです	はい	advancedColorInfo.SdrWhiteLevelInNits 、詳細については、「DirectX with Advanced Color on HDR/SDR displays」を参照してください。

Windows 11 バージョン 22H2 9 月の更新プログラムで実行するときの動作の違い

基になる OS 機能により、Windows 11 バージョン 22H2 9 月の更新プログラムで実行するときに HDR および WCG カラー モードを要求するドライバーのサポートは、2024 年にリリースされる Windows プラットフォーム で実行されている場合とは若干異なります。 ドライバーは、IddCxGetVersion 関数を使用して、実行されている OS を決定できます。 次の表では、以前に OS に提供されたモニター記述子に応じてドライバーが要求できる色モードについて説明します。

Edid 型	22H2 9 月更新可能なカラー モード	2024 年のプラットフォーム リリースで使用可能なカラー モード
何一つ	SDR、HDR	SDR、SDRWCG、HDR
SDR	SDR、SDRWCG	SDR、SDRWCG
HDR	SDR、HDR	SDR、SDRWCG、HDR

例

後続の IddCxAdapterDisplayConfigUpdate2 呼び出しに含めるパスの例をいくつか次に示します。 各シナリオの開始時に、リモート セッションには次のパスが構成されています。

モニター	解決	デスクトップの位置	カラー モード
1	1920x1080 @ 30Hz	0,0	SDR
2	1024 x 768 @ 30Hz	1024,0	SDRWCG
3	3840x2160 @ 30Hz	0,1848	HDR

シナリオ 1 - モニター 3 のデスクトップ位置をモニター 1 の左側に変更する

モニター	フラグ	細部
1	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データへの変更なし
2	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データへの変更なし
3	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	デスクトップの位置を -3840,0 に変更する

シナリオ 2 – モニター 2 を SDRWCG から SDR に変更する

モニター	フラグ	細部
1	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データへの変更なし
2	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	新しいカラー モードを設定する
3	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データへの変更なし

シナリオ 3 – モニター 1 を SDR から HDR に変更する

モニター	フラグ	細部
1	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID、IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID、IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID	新しいカラー モード、カラーメトリー、SDR ホワイト レベルを設定する
2	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データへの変更なし
3	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データへの変更なし

シナリオ 4 – モニター 2 のスケール ファクターを変更する

モニター	フラグ	細部
2	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID	新しいスケール ファクターを設定する

シナリオ 5 – モニター 2 のスケール ファクターとモニター 3 のデスクトップ位置をモニター 1 の左側に変更する

モニター	フラグ	細部
1	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データへの変更なし
2	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID、IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID	現在のモード データに変更なし、新しいスケール ファクターを設定する
3	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	デスクトップの位置を -3840,0 に変更する

シナリオ 6 – 現在の構成からモニター 2 を削除する

モニター	フラグ	細部
1	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データへの変更なし
3	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データへの変更なし

必要条件

要件	価値
サポートされる最小クライアント	Windows 11 バージョン 22H2 September Update (IddCx バージョン 1.10)
ヘッダー	iddcx.h

関連項目

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2