Share via

функция обратного вызова DXGKDDI_SETTIMINGSFROMVIDPN (d3dkmddi.h)

  • Статья

DXGKDDI_SETTIMINGSFROMVIDPN вызывается для установки или изменения времени отображения на адаптере. Этот DDI заменяет DxgkDdiCommitVidPn.

Синтаксис

DXGKDDI_SETTIMINGSFROMVIDPN DxgkddiSettimingsfromvidpn;

NTSTATUS DxgkddiSettimingsfromvidpn(
  [in]      IN_CONST_HANDLE hAdapter,
  [in, out] IN_OUT_PDXGKARG_SETTIMINGSFROMVIDPN pSetTimings
)
{...}

Параметры

[in] hAdapter

Идентифицирует адаптер, для которого должно быть задано время отображения.

[in, out] pSetTimings

Указатель на структуру DXGKARG_SETTIMINGSFROMVIDPN , описывающую время отображения, которое необходимо задать.

Возвращаемое значение

Если эта подпрограмма завершается успешно, она возвращает STATUS_SUCCESS.

Примечание Драйвер всегда должен возвращать код успешного выполнения, если в параметрах не произошла ошибка или не удалось обработать запрос. Если драйвер не может задать один или несколько путей в соответствии с запросом, он должен описать условие с помощью полей выходных данных, но по-прежнему сообщать об успешном выполнении.
 

Комментарии

Драйвер режима ядра оценивает параметры и инициирует изменения, если никакие условия не препятствуют их попытке. Если такие условия, как превышение ограничений целевой пропускной способности, препятствуют внесению изменений, драйвер должен описать условия. Если изменение времени возможно, но сначала требует завершения подготовительных работ, драйвер должен указать это в выходных флагах.

Эта функция всегда вызывается на уровне PASSIVE.

Эта функция регистрируется с помощью DriverEntry драйвера мини-порта дисплея.

Начиная с WDDM 2.6, когда синхронизация отображения доступна и нужно включить несколько дисплеев, ОПЕРАЦИОННая система укажет, что дисплеи должны быть синхронизированы в вызове DXGKDDI_SETTIMINGSFROMVIDPN. Каждый путь для синхронизации будет иметь ненулевое значение в битовом поле SyncLockGroup и выбранный стиль синхронизации в поле SyncLockStyle , оба из которых находятся в DXGK_SET_TIMING_PATH_INFO структуре.

Требования

Требование Значение
Целевая платформа Windows
Header d3dkmddi.h
IRQL PASSIVE_LEVEL