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

Статья
02/06/2025

Уведомляет мини-драйвер отображения о определенных событиях ACPI.

Синтаксис

DXGKDDI_NOTIFY_ACPI_EVENT DxgkddiNotifyAcpiEvent;

NTSTATUS DxgkddiNotifyAcpiEvent(
  [in]  IN_CONST_PVOID MiniportDeviceContext,
  [in]  IN_DXGK_EVENT_TYPE EventType,
  [in]  IN_ULONG Event,
  [in]  IN_PVOID Argument,
  [out] OUT_PULONG AcpiFlags
)
{...}

Параметры

[in] MiniportDeviceContext

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

[in] EventType

Перечислитель DXGK_EVENT_TYPE, предоставляющий тип события (DpAcpiEvent, DpPowerStateEvent, DpDockingEvent).

[in] Event

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

Тип события	Возможные номера событий
DpAcpiEvent	Ниже перечислены допустимые события, определенные в Dispmprt.h: ACPI_NOTIFY_CYCLE_DISPLAY_HOTKEY — уведомляет операционную систему о том, что пользователь нажимал клавишу HOTKEY для отображения цикла. ACPI_NOTIFY_DOCK_EVENT — указывает, что произошло событие закрепления. Например, пользователь закрепил или отключил мобильный компьютер. ACPI_NOTIFY_DEVICE_HOTPLUG. Указывает, что состояние любого выходного устройства, подключенного к контроллеру VGA, было изменено. Например, пользователь удалил или подключил экран CRT к порту VGA. ACPI_NOTIFY_PANEL_SWITCH . Указывает, что состояние одного из выходных устройств, подключенных к контроллеру VGA, было переключено. Например, пользователь переключил активный выходной дисплей с lcd на тип дисплея CRT. ACPI_NOTIFY_VIDEO_WAKEUP — указывает, что вывод был возобновлен. Например, пользователь повторно активировал экран компьютера.
DpPowerStateEvent	PO_CB_LID_SWITCH_STATE, PO_CB_AC_STATUS Определяется в Wdm.h.
DpDockingEvent	ACPI_NOTIFY_DOCK_EVENT — указывает, что произошло событие закрепления. Например, пользователь закрепил или отключил мобильный компьютер. Определен в Dispmprt.h.

[in] Argument

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

Номер события	Возможные аргументы событий
PO_CB_AC_STATUS	0 — указывает, что система находится на заряде батареи. 1. Указывает, что система находится в системе с питанием AC.
PO_CB_LID_SWITCH_STATE	0 — указывает, что крышка закрывается. 1 . Указывает, что крышка открывается.

[out] AcpiFlags

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

значение	типа запроса
DXGK_ACPI_CHANGE_DISPLAY_MODE	Драйвер минипорта отображения отправляет запрос операционной системе для вызова функции DxgkDdiRecommendFunctionalVidPn, а затем инициировать изменение режима в новой рекомендуемой активной сети представления видео (VidPN). Например, драйвер мини-порта отображения может сделать этот запрос, если пользователь указал изменение режима.
DXGK_ACPI_CHANGE_DISPLAY_TOPOLOGY
DXGK_ACPI_POLL_DISPLAY_CHILDREN	Минипорт-драйвер дисплея отправляет запрос операционной системе для опроса подключения дочерних элементов адаптера дисплея, представленного MiniportDeviceContext.
DXGK_ACPI_CHAIN_NOT_HANDLED	Указывает, что событие с типом DxgkChainedAcpiEvent не обрабатывается гибридным дискретным драйвером и поэтому следует отправлять в гибридный интегрированный драйвер.

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

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

DxgkDdiNotifyAcpiEvent возвращает STATUS_SUCCESS, если оно успешно; в противном случае возвращается один из кодов ошибок, определенных в Ntstatus.h.

Замечания

DxgkDdiNotifyAcpiEvent является необязательной функцией драйвера мини-порта дисплея.

DxgkDdiNotifyAcpiEvent должен быть доступен для страницы.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	dispmprt.h
IRQL	PASSIVE_LEVEL

См. также

DxgkCbEvalAcpiMethod

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