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

  • Статья

Драйвер мини-порта в режиме ядра вызывает DXGKCB_MULTIPLANEOVERLAYDISABLED , чтобы указать, что текущая конфигурация многопланового наложения (MPO) больше не поддерживается в указанном VidPnSourceId.

Синтаксис

DXGKCB_MULTIPLANEOVERLAYDISABLED DxgkcbMultiplaneoverlaydisabled;

void DxgkcbMultiplaneoverlaydisabled(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT VidPnSourceId
)
{...}

Параметры

[in] hAdapter

Дескриптор для адаптера, на котором текущая конфигурация оборудования MPO больше не поддерживается.

[in] VidPnSourceId

VidPnSourceId, для которого текущая конфигурация оборудования MPO больше не поддерживается.

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

None

Remarks

DXGKCB_MULTIPLANEOVERLAYDISABLED уведомляет диспетчер Windows (DWM) о том, что текущая конфигурация MPO больше не поддерживается, что позволяет DWM вернуться к композиции.

Этот запрос обрабатывается асинхронно и может быть отложен на несколько кадров. Эту функцию рекомендуется вызывать только в исключительных случаях, например в следующих сценариях:

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

  • MPO следует отключить из-за проблем с температурой. В этом случае драйверу не нужно немедленно отключать MPO, но он может ждать, пока DWM получит уведомление и нуждается в поддержке MPO (что KMD должно указать, что не поддерживается из-за проблемы с температурой). В это время DWM отключит MPO и начнет создание.

В типичных случаях драйверы должны предотвращать несовместимые конфигурации многопланового наложения, правильно отвечая на DxgkDdiCheckMultiplaneOverlaySupport3.

DXGKCB_XXX функции реализуются Dxgkrnl. Чтобы использовать эту функцию обратного вызова, вызовите DxgkCbMultiPlaneOverlayDisabled через DXGKRNL_INTERFACE.

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1607 (WDDM 2.1)
Целевая платформа Windows
Header d3dkmddi.h
IRQL <= PASSIVE_LEVEL

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

DxgkDdiCheckMultiplaneOverlaySupport3

DXGKRNL_INTERFACE