функция обратного вызова 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 больше не поддерживается.
Возвращаемое значение
Никакой
Замечания
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) |
| целевая платформа | Виндоус |
| заголовка | d3dkmddi.h |
| IRQL | <= PASSIVE_LEVEL |