Skip to content

Latest commit

 

History

History
86 lines (63 loc) · 4.31 KB

nf-wdm-pofxreportdevicepoweredon.md

File metadata and controls

86 lines (63 loc) · 4.31 KB
Raw
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:wdm.PoFxReportDevicePoweredOn
PoFxReportDevicePoweredOn function (wdm.h)
The PoFxReportDevicePoweredOn routine notifies the power management framework (PoFx) that the device completed the requested transition to the D0 (fully on) power state.
kernel\pofxreportdevicepoweredon.htm
kernel
09/14/2021
PoFxReportDevicePoweredOn function
PoFxReportDevicePoweredOn, PoFxReportDevicePoweredOn routine [Kernel-Mode Driver Architecture], kernel.pofxreportdevicepoweredon, wdm/PoFxReportDevicePoweredOn
wdm.h
Universal
Available starting with Windows 8.
Ntoskrnl.lib
Ntoskrnl.exe
<= DISPATCH_LEVEL
Windows
PoFxReportDevicePoweredOn
wdm/PoFxReportDevicePoweredOn
APIRef
kbSyntax
DllExport
Ntoskrnl.exe
PoFxReportDevicePoweredOn

PoFxReportDevicePoweredOn function

-description

The PoFxReportDevicePoweredOn routine notifies the power management framework (PoFx) that the device completed the requested transition to the D0 (fully on) power state.

-parameters

-param Handle [in]

A handle that represents the registration of the device with the power management framework (PoFx). The device driver previously received this handle from the PoFxRegisterDevice routine.

-remarks

The driver for a registered device must call PoFxReportDevicePoweredOn after any of the following occurrences:

  • PoFx calls the driver's DevicePowerRequiredCallback callback routine to notify the driver that the device must enter the D0 power state.
  • PoFx calls the driver's DirectedPowerUpCallback callback routine to notify the driver that the device must enter the D0 power state.
  • PoFx sends the driver an S0 IRP (an IRP_MN_SET_POWER request) to notify the driver of a pending system transition to the S0 power state.
In response to either occurrence, the driver sends D0 IRP (an IRP_MN_SET_POWER request) down its device stack to initiate a transition to the D0 power state, if the device is not already in the D0 state. After the driver completes (and all lower drivers complete) the transition to the D0 state, the driver calls PoFxReportDevicePoweredOn to notify PoFx.

The driver must call PoFxReportDevicePoweredOn regardless of whether no D0 IRP is required, the D0 IRP request fails, the dispatched D0 IRP succeeds or fails, or the S0 IRP succeeds or fails.

For power required / directed power up callback, the PoFxReportDevicePoweredOn call can occur either during or after the callback call.

For an S0 IRP request, the driver must complete this request as soon as possible, switch the device to the D0 power state, and call PoFxReportDevicePoweredOn. For more information, see Handling a System Set-Power IRP in a Device Power Policy Owner.

On entry to PoFxReportDevicePoweredOn, the device might be in an uninitialized D0 power state in which all of the components in the device are turned on. In response to the PoFxReportDevicePoweredOn call, PoFx configures the device in an initialized D0 state. During this configuration, PoFx switches as many components as it can to low-power Fx power states.

-see-also

DevicePowerRequiredCallback

IRP_MN_SET_POWER

PoFxRegisterDevice