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

  • Статья

Подпрограмма PoFxStartDevicePowerManagement завершает регистрацию устройства с помощью платформы управления питанием (PoFx) и запускает управление питанием устройства.

Синтаксис

void PoFxStartDevicePowerManagement(
  [in] POHANDLE Handle
);

Параметры

[in] Handle

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

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

None

Remarks

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

После того как PoFxStartDevicePowerManagement переключит компонент на условие простоя, PoFx может сразу же начать вызывать процедуры обратного вызова драйвера, даже до того, как poFxStartDevicePowerManagement вернет. PoFx вызывает подпрограмму обратного вызова ComponentIdleConditionCallback драйвера, чтобы указать, что компонент переключился на условие простоя. Драйвер не должен обращаться к компоненту, который находится в состоянии простоя. Прежде чем драйвер сможет получить доступ к компоненту, драйвер должен вызвать PoFxActivateComponent и дождаться, пока PoFx вызовет подпрограмму обратного вызова ComponentActiveConditionCallback драйвера. Этот обратный вызов информирует драйвер о том, что компонент находится в активном состоянии и может быть безопасно доступен.

Если драйвер требует, чтобы компонент был в активном состоянии сразу после запуска управления питанием, драйвер должен явно активировать компонент, вызвав подпрограмму PoFxActivateComponent , и этот вызов должен происходить после вызова PoFxRegisterDevice, но до вызова PoFxStartDevicePowerManagement .

Требования

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

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

ComponentActiveConditionCallback

ComponentIdleConditionCallback

PoFxActivateComponent

PoFxRegisterDevice