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

모니터	해상도	바탕 화면 위치	색 모드
1	1920x1080 @ 30Hz	0,0	SDR
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