IddCxAdapterDisplayConfigUpdate2 関数 (iddcx.h)

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

構文

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

パラメーター

AdapterObject

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

pInArgs

[入力]関数への入力引数を含む 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	Yes	Yes

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

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

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

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

基になる OS 機能により、Windows 11で実行されている場合に HDR および WCG カラー モードを要求するドライバーのサポート、バージョン 22H2 9 月の更新プログラムは、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 呼び出しに含めるパスの例をいくつか示します。 各シナリオの開始時に、リモート セッションには次のパスが構成されています。

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

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

Monitor	Flags	詳細
1	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データに変更はありません
2	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データに変更はありません
3	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	デスクトップの位置を -3840,0 に変更する

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

Monitor	Flags	詳細
1	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データに変更はありません
2	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	新しいカラー モードを設定する
3	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データに変更はありません

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

Monitor	Flags	詳細
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 のスケール ファクターを変更する

Monitor	Flags	詳細
2	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID	新しいスケール ファクターを設定する

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

Monitor	Flags	詳細
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 を削除する

Monitor	Flags	詳細
1	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データに変更はありません
3	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	現在のモード データに変更はありません

要件

要件	値
サポートされている最小のクライアント	Windows 11、バージョン 22H2 9 月の更新プログラム (IddCx バージョン 1.10)
Header	iddcx.h

こちらもご覧ください

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2