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

Статья
02/06/2025

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.

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

Замечания

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

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

Эта функция зарегистрирована DriverEntry драйвера минипорта отображения.

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

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Поделиться через