共用方式為

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，或 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
特別提款 權 不 不
SDRWCG 是的 不
HDR 是的 是的

第一次與後續對IddCxAdapterDisplayConfigUpdate2的呼叫

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

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

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

由於基礎作系統功能，在 Windows 11 版本 22H2 9 月更新上執行時，要求 HDR 和 WCG 色彩模式的驅動程式支援與在 2024 年推出的 Windows 平臺版本上執行時稍有不同。 驅動程式可以使用 IddCxGetVersion 函式來判斷其執行所在的作系統。 下表說明驅動程式可根據先前提供給OS的監視器描述元，要求哪些色彩模式：

Edid 類型 22H2 9 月更新可能的色彩模式 2024 年可能色彩模式的平臺版本
沒有 SDR、HDR SDR、SDRWCG、HDR
特別提款 權 SDR、SDRWCG SDR、SDRWCG
HDR SDR、HDR SDR、SDRWCG、HDR

例子

後續 IddCxAdapterDisplayConfigUpdate2 呼叫中要包含哪些路徑的範例。 在每個案例開始時，遠端會話已設定下列路徑：

監控 解析度 桌面位置 色彩模式
1 1920x1080 @ 30Hz 0,0 特別提款 權
2 1024x768 @ 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 9 月更新 （IddCx 1.10 版）
標頭 iddcx.h

另請參閱

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2