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

  • Статья

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

Комментарии

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

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

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

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

Требования

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