Функция PoFxReportDevicePoweredOn (wdm.h)

Статья
08/08/2023

Подпрограмма PoFxReportDevicePoweredOn уведомляет платформу управления питанием (PoFx), что устройство завершило запрошенный переход в состояние питания D0 (полностью включено).

Синтаксис

void PoFxReportDevicePoweredOn(
  [in] POHANDLE Handle
);

Параметры

[in] Handle

Дескриптор, представляющий регистрацию устройства с помощью платформы управления питанием (PoFx). Драйвер устройства ранее получил этот дескриптор из подпрограммы PoFxRegisterDevice .

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

None

Remarks

Драйвер для зарегистрированного устройства должен вызывать PoFxReportDevicePoweredOn после любого из следующих вхождений:

PoFx вызывает подпрограмму обратного вызова DevicePowerRequiredCallback драйвера, чтобы уведомить драйвер о том, что устройство должно войти в состояние питания D0.
PoFx вызывает подпрограмму обратного вызова DirectedPowerUpCallback драйвера, чтобы уведомить драйвер о том, что устройство должно войти в состояние питания D0.
PoFx отправляет драйверу S0 IRP ( запрос IRP_MN_SET_POWER ), чтобы уведомить его об ожидающих переходе системы в состояние питания S0.

В ответ на любое событие драйвер отправляет D0 IRP ( запрос IRP_MN_SET_POWER ) в стек устройства, чтобы инициировать переход в состояние питания D0, если устройство еще не находится в состоянии D0. После завершения работы драйвера (и завершения всех более низких драйверов) переход в состояние D0 драйвер вызывает PoFxReportDevicePoweredOn , чтобы уведомить PoFx.

Драйвер должен вызывать PoFxReportDevicePoweredOn независимо от того, не требуется ли D0 IRP, запрос D0 IRP завершается ошибкой, успешно или сбоем отправленного D0 IRP или S0 IRP успешно или неудачно.

Для обратного вызова, требуемого питания или направленного питания, вызов PoFxReportDevicePoweredOn может выполняться во время или после обратного вызова.

Для запроса S0 IRP драйвер должен выполнить этот запрос как можно скорее, переключить устройство в состояние питания D0 и вызвать PoFxReportDevicePoweredOn. Дополнительные сведения см. в разделе Обработка системного Set-Power IRP в владельце политики управления питанием устройства.

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.
Целевая платформа	Универсальное
Верхняя часть	wdm.h
Библиотека	Ntoskrnl.lib
DLL	Ntoskrnl.exe
IRQL	<= DISPATCH_LEVEL

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

DevicePowerRequiredCallback

IRP_MN_SET_POWER

PoFxRegisterDevice

Share via