Функция 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 , чтобы задать режим, цветоиметрию и другие значения, которые ОС должна использовать для определенного монитора. Только удаленные драйверы могут вызывать эту функцию.

Дополнительные сведения о поддержке 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 , то должны присутствовать только обновляемые пути.
• В зависимости от указанного цветового режима для пути могут потребоваться дополнительные данные. В следующей таблице показано, какие дополнительные флаги необходимо задать.

Первый и последующий вызов IddCxAdapterDisplayConfigUpdate2

При первом включении пути в вызов IddCxAdapterDisplayConfigUpdate2 требования отличаются от последующих. Требования приведены в следующей таблице.

Различия в поведении при работе в Windows 11 версии 22H2 с обновлением за сентябрь

Из-за базовых функциональных возможностей ОС поддержка драйверов, запрашивающих цветовые режимы HDR и WCG при работе в Windows 11 версии 22H2 сентябрьского обновления, немного отличается от поддержки при запуске на платформе Windows, выходящем в 2024 году. Драйвер может использовать функцию IddCxGetVersion для определения операционной системы, в которой он работает. В следующей таблице описывается, какие цветовые режимы может запрашивать драйвер в зависимости от дескриптора монитора, ранее предоставленного для ОС:

Примеры

Ниже приведены некоторые примеры путей для включения в последующие вызовы IddCxAdapterDisplayConfigUpdate2 . В начале каждого сценария удаленный сеанс имеет следующие настроенные пути:

Сценарий 1. Изменение положения рабочего стола монитора 3 налево от монитора 1

Сценарий 2. Изменение монитора 2 с SDRWCG на SDR

Сценарий 3. Изменение монитора 1 с SDR на HDR

Сценарий 4. Изменение коэффициента масштабирования монитора 2

Сценарий 5. Изменение коэффициента масштабирования монитора 2 и положения рабочего стола монитора 3 налево от монитора 1

Сценарий 6. Удаление монитора 2 из текущей конфигурации

Требования

См. также раздел

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2