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	예	No
SDRWCG	Yes	아니요
Hdr	Yes	Yes

IddCxAdapterDisplayConfigUpdate2에 대한 첫 번째 및 후속 호출

경로가 IddCxAdapterDisplayConfigUpdate2 호출에 처음 포함되는 경우 후속 시간과 다른 요구 사항이 있습니다. 다음 표에서는 요구 사항을 간략하게 설명합니다.

경로 필드	경로에 대한 초기 호출에 필요	초기 호출 후 업데이트 가능	Windows 클라이언트에서 정보를 가져오는 방법
모드	Yes	Yes	QueryDisplayConfig 는 클라이언트 표시 구성을 제공하고 표시 구성이 변경될 때 WM_DISPLAYCHANGE 전송됩니다. AdvancedColorInfo.CurrentAdvancedColorKind 는 색 모드를 제공합니다.
배율	Yes	Yes	드라이버는 IddCxAdapterDisplayConfigUpdate에 사용되는 메서드를 사용할 수 있습니다.
물리적 크기	EDID가 전달되지 않은 경우 예	No	EDID가 통과된 경우 필요하지 않음
Colorimetry	비 SDR 색 모드의 경우 예	Yes	해당 AdvancedColorInfo 필드의 대부분의 필드
SDR 흰색 수준	HDR 색 모드의 경우 예, 기본값은 80니트입니다.	Yes	AdvancedColorInfo.SdrWhiteLevelInNits, 자세한 내용은 HDR/SDR 디스플레이에서 고급 색이 있는 DirectX 를 참조하세요.

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 호출에 포함할 경로의 몇 가지 예는 다음과 같습니다. 각 시나리오가 시작될 때 원격 세션에는 다음과 같은 경로가 구성됩니다.

Monitor	해결 방법	바탕 화면 위치	색 모드
1	1920x1080 @ 30Hz	0,0	SDR
2	1024x768 @ 30Hz	1024,0	SDRWCG
3	3840x2160 @ 30Hz	0,1848	Hdr

시나리오 1 - 모니터 3의 바탕 화면 위치를 모니터 1의 왼쪽으로 변경

Monitor	플래그	세부 정보
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	플래그	세부 정보
1	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	현재 모드 데이터에 대한 변경 없음
2	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	새 색 모드 설정
3	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	현재 모드 데이터에 대한 변경 없음

시나리오 3 – 모니터 1을 SDR에서 HDR로 변경

Monitor	플래그	세부 정보
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	플래그	세부 정보
2	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID	새 배율 인수 설정

시나리오 5 – 모니터 2의 배율 인수 및 모니터 3의 바탕 화면 위치를 모니터 1의 왼쪽으로 변경

Monitor	플래그	세부 정보
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	플래그	세부 정보
1	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	현재 모드 데이터에 대한 변경 없음
3	IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID	현재 모드 데이터에 대한 변경 없음

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 11 버전 22H2 9월 업데이트(IddCx 버전 1.10)
머리글	iddcx.h

추가 정보

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2