IddCxAdapterDisplayConfigUpdate2 函式 (iddcx.h)

發行項
02/26/2024

遠端驅動程式可以呼叫 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，或 IddCxAdapterDisplayConfigUpdate2 ，某些路徑可能無法提供色彩測量數據，而只有在不需要配置變更時，才可呼叫 IddCxAdapterDisplayConfigUpdate2 來更新 SDR 白色層級。

控制模式 (設定路徑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	No	No
SDRWCG	是	No
HDR	Yes	Yes

第一次與後續對IddCxAdapterDisplayConfigUpdate2的呼叫

第一次在 IddCxAdapterDisplayConfigUpdate2 呼叫中包含路徑時，其需求與後續時間不同。下表概述需求。

路徑欄位	路徑初始呼叫中的必要專案	可以在初始呼叫之後更新	Windows 用戶端如何取得資訊
模式	Yes	Yes	QueryDisplayConfig 將會提供客戶端顯示設定，並在顯示設定變更時傳送 WM_DISPLAYCHANGE ; AdvancedColorInfo.CurrentAdvancedColorKind 會提供色彩模式
比例因素	Yes	Yes	驅動程式可以使用用於IddCxAdapterDisplayConfigUpdate的方法
實體大小	如果未傳遞任何 EDID，則為是	No	如果傳遞EDID，則不需要
色度	適用於非 SDR 色彩模式的是	Yes	來自對應 AdvancedColorInfo 欄位的大部分欄位
SDR 白色層級	如果是 HDR 色彩模式，預設值為 80 nits	Yes	AdvancedColorInfo.SdrWhiteLevelInNits，如需詳細資訊，請參閱 HDR/SDR 顯示器上具有進階色彩的 DirectX

在 Windows 11 版本 22H2 9 月更新上執行時的行為差異

由於基礎OS功能，在Windows 11 22H2月更新上執行時，要求HDR和WCG色彩模式的驅動程序支援與在2024年2024年2024年推出的Windows平臺版本上執行時稍有不同。驅動程式可以使用 IddCxGetVersion 函式來判斷其執行所在的作業系統。下表描述驅動程式可以根據先前提供給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	1024x768 @ 30Hz	1024,0	SDRWCG
3	3840x2160 @ 30Hz	0,1848	HDR

案例 1 - 將監視器 3 的桌面位置變更為 [監視器 1] 左側

監視器	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

監視器	Flags	詳細資料
1	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	目前模式數據沒有變更
2	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	設定新的色彩模式
3	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	目前模式數據沒有變更

案例 3 – 將監視器 1 從 SDR 變更為 HDR

監視器	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 的縮放比例

監視器	Flags	詳細資料
2	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID	設定新的縮放比例

案例 5 – 將監視器 2 的縮放比例和監視器 3 桌面位置變更為監視器 1 的左側

監視器	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

監視器	Flags	詳細資料
1	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	目前模式數據沒有變更
3	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	目前模式數據沒有變更

規格需求

需求	值
最低支援的用戶端	Windows 11 版本 22H2 9 月更新 (IddCx 1.10 版)
標頭	iddcx.h

另請參閱

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2

共用方式為