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 아닌 플래그만 설정된 경우 업데이트할 경로만 있어야 합니다.
• 지정된 색 모드에 따라 경로에 대한 추가 데이터가 필요할 수 있습니다. 다음 표는 설정해야 하는 추가 플래그를 나타냅니다.

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

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

Windows 11 버전 22H2 9월 업데이트에서 실행할 때의 동작 차이

기본 OS 기능으로 인해 Windows 11, 버전 22H2 9월 업데이트에서 실행할 때 HDR 및 WCG 색 모드를 요청하는 드라이버에 대한 지원은 2024년 Windows 플랫폼 릴리스에서 실행될 때와 약간 다릅니다. 드라이버는 IddCxGetVersion 함수를 사용하여 실행 중인 OS를 확인할 수 있습니다. 다음 표에서는 이전에 OS에 제공된 모니터 설명자에 따라 드라이버가 요청할 수 있는 색 모드에 대해 설명합니다.

예제

후속 IddCxAdapterDisplayConfigUpdate2 호출에 포함할 경로의 몇 가지 예는 다음과 같습니다. 각 시나리오가 시작될 때 원격 세션에는 다음과 같은 경로가 구성됩니다.

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

시나리오 2 – 모니터 2를 SDRWCG에서 SDR로 변경

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

시나리오 4 – 모니터 2의 배율 인수 변경

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

시나리오 6 – 현재 구성에서 모니터 2 제거

요구 사항

추가 정보

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2