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

Статья
01/16/2025

Dxgkrnl вызывает драйвер в режиме ядра (KMD) DxgkddiDisplayMuxSwitchCanceled функцию, чтобы уведомить драйвер о том, что последовательность коммутатора была отменена до завершения.

Синтаксис

DXGKDDI_DISPLAYMUX_SWITCH_CANCELED DxgkddiDisplaymuxSwitchCanceled;

NTSTATUS DxgkddiDisplaymuxSwitchCanceled(
  PVOID DriverContext,
  ULONG VidPnTargetId,
  BOOLEAN MuxSwitchedToTarget
)
{...}

Параметры

DriverContext

[in] Обработка блока контекста, связанного с адаптером дисплея. Функция KMD DxgkDdiAddDevice ранее предоставила этот дескриптор для Dxgkrnl.

VidPnTargetId

[in] Целевой объект VidPN, к которому вызывается DDI.

MuxSwitchedToTarget

[in] Логическое значение, указывающее, переключается ли в данный момент мьюкс отображения для подключения целевого объекта, определенного VidPnTargetId на панель.

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

DxgkddiDisplayMuxSwitchCanceled возвращает STATUS_SUCCESS, если он выполнен успешно. В противном случае возвращается соответствующий код ошибки.

Замечания

Этот DDI вызывается в уровне синхронизации 2.

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

MuxSwitchedToTarget	Мьюкс был переключлен на GPU перед переключением	Мьюкс был отключен от GPU перед переключением
ЛОЖНЫЙ	Убедитесь, что драйвер отключил питание на внутреннюю панель, отключенные уровни яркости и перестал отправлять уровни яркости в мьюкс. Драйвер или GPU готов к следующей последовательности коммутаторов.	Ничто
ИСТИННЫЙ	Если драйвер уже сообщил об отключенной крышке, добавьте новый пакет изменения подключения, чтобы сообщить об крышке как подключенной снова. Драйвер или GPU должен быть готов к вызову DxgkddiSettimingsfromvidpn, который будет выполняться в ближайшее время. На следующем вызове DxgkddiSettimingsfromvidpn драйвер должен убедиться, что PSR отключен.	Если драйвер еще не сообщил, что крышка подключена, добавьте пакет изменения подключения, чтобы сообщить об подключенной крышке. Драйвер или GPU должен быть готов к вызову DxgkddiSettimingsfromvidpn, который будет выполняться в ближайшее время. На следующем вызове DxgkddiSettimingsfromvidpn драйвер должен убедиться, что PSR отключен.

Дополнительные сведения см. в автоматического переключателя отображения.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 11 версии 24H2, обновление 2025.01
заголовка	dispmprt.h
IRQL	PASSIVE_LEVEL

См. также

DxgkddiSettimingsfromvidpn

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