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

Статья
08/08/2023

Функция обратного вызова PO_FX_DIRECTED_POWER_UP_CALLBACK реализуется драйвером клиента для обработки определенных драйверов действий по включению питания от имени DFx (Directed PoFx).

Синтаксис

PO_FX_DIRECTED_POWER_UP_CALLBACK PoFxDirectedPowerUpCallback;

void PoFxDirectedPowerUpCallback(
  PVOID Context,
  ULONG Flags
)
{...}

Параметры

Context

Предоставляет указатель на контекст, передаваемый в PoFxRegisterDevice.

Flags

Зарезервировано для последующего использования.

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

None

Remarks

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

Зарегистрируйте реализацию этой функции обратного вызова, задав соответствующий член структуры PO_FX_DEVICE_V3 и вызвав PoFxRegisterDevice.

Этот обратный вызов вызывается, когда система определяет, что устройство необходимо включить после выключения ранее в функции обратного вызова PO_FX_DIRECTED_POWER_DOWN_CALLBACK . Устройство может потребоваться включить, когда система выходит из режима ожидания modern Standby, активаторы запускаются или происходит инициированный оборудованием пробуждение.

При вызове этого обратного вызова драйвер обычно выполняет следующие высокоуровневые задачи:

Запросите D0 IRP для включения питания устройства.
После завершения D0 IRP вызовите PoFxReportDevicePoweredOn.
Разблокируйте очереди ввода-вывода и начните обработку запросов в обычном режиме.

После завершения вызова направленного включения питания драйвер может возобновить работу в режиме простоя среды выполнения (RTD3).

Контракт очень похож на S0, хотя S-IRP не участвует.

Обратите внимание, что если используется иерархия устройств, то платформа управления питанием запрашивает выключение дочерних устройств перед родительским устройством. Для данного родительского устройства учитываются прямые дочерние элементы (перечисляемые родительским элементом) и косвенные дочерние элементы из-за отношений власти .

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 версии 1903
Верхняя часть	wdm.h (включая Wdm.h)

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

Введение в платформу управления направленным питанием

PO_FX_DIRECTED_POWER_DOWN_CALLBACK

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