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

Статья
02/06/2025

Вызывается после того, как была вложена новая конфигурация многоуровневого наложения, что позволяет драйверу оптимизировать состояние оборудования. Необязательно для драйверов windows Display Driver Model (WDDM) 2.0 или более поздних версий, поддерживающих многоуровневые наложения.

Синтаксис

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT DxgkddiPostmultiplaneoverlaypresent;

NTSTATUS DxgkddiPostmultiplaneoverlaypresent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_POSTMULTIPLANEOVERLAYPRESENT pPostPresent
)
{...}

Параметры

hAdapter

Определяет адаптер, содержащий оборудование наложения.

pPostPresent

Указатель на структуру DXGKARG_POSTMULTIPLANEOVERLAYPRESENT, описывающую недавно зафиксированную конфигурацию наложения.

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

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT возвращает следующие значения:

Возвращаемый код	Описание
STATUS_SUCCESS	Если подпрограмма успешно завершена. Драйвер всегда должен возвращать код успешности. Сбои приведут к ошибке.

Замечания

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

Эта функция вызывается только в том случае, если драйвер задает PostPresentNeeded DXGKCB_NOTIFY_MPO_VSYNC_FLAGS член структуры DXGKARGCB_NOTIFY_INTERRUPT_DATA в обратном вызове VSYNC.

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

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

Требования

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

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