функция обратного вызова PO_FX_DIRECTED_POWER_UP_CALLBACK (wdm.h)
Функция обратного вызова PO_FX_DIRECTED_POWER_UP_CALLBACK реализуется драйвером клиента для обработки действий по настройке питания для конкретного драйвера от имени DFx (Направленная PoFx).
Синтаксис
PO_FX_DIRECTED_POWER_UP_CALLBACK PoFxDirectedPowerUpCallback;
void PoFxDirectedPowerUpCallback(
PVOID Context,
ULONG Flags
)
{...}
Параметры
Context
Предоставляет указатель на контекст, переданный в PoFxRegisterDevice.
Flags
Зарезервировано для дальнейшего использования.
Возвращаемое значение
Никакой
Замечания
Драйверы WDM, которые регистрируются в PoFx для поддержки управления питанием среды выполнения, необходимо реализовать этот обратный вызов, чтобы добавить поддержку DFx.
Зарегистрируйте реализацию этой функции обратного вызова, задав соответствующий член структуры PO_FX_DEVICE_V3, а затем вызовите PoFxRegisterDevice.
Этот обратный вызов вызывается, когда система определяет, что устройство должно включить питание после того, как ранее был включен в функцию обратного вызова PO_FX_DIRECTED_POWER_DOWN_CALLBACK. При выходе системы из современной резервной системы может потребоваться запустить устройство, активаторы начать работу или возникает инициированное оборудованием пробуждение.
При вызове этого обратного вызова драйвер обычно выполняет следующие высокоуровневые задачи:
Попросите D0 IRP включить устройство.
После завершения IRP D0 вызовите PoFxReportDevicePoweredOn.
Разблокируйте очереди ввода-вывода и обычно запускаете обработку запросов.
После завершения вызова перенаправленного питания драйвер может возобновить работу среды выполнения (RTD3).
Контракт очень похож на S0, хотя не участвуют S-IRPs.
Обратите внимание, что если используется иерархия устройств, то целевая платформа питания просит дочерние устройства отключать устройство перед родительским устройством. Для данного родительского устройства рассматриваются прямые дочерние (перечисленные родительскими) и косвенные дочерние элементы из-за отношений питания.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 10 версии 1903 |
| заголовка | wdm.h (include Wdm.h) |