PoFxCompleteIdleState function (wdm.h)

Article
02/25/2022

The PoFxCompleteIdleState routine informs the power management framework (PoFx) that the specified component has completed a pending change to an Fx state.

Syntax

void PoFxCompleteIdleState(
  [in] POHANDLE Handle,
  [in] ULONG    Component
);

Parameters

[in] Handle

A handle that represents the registration of the device with PoFx. The device driver previously received this handle from the PoFxRegisterDevice routine.

[in] Component

The index that identifies the component. This parameter is an index into the Components array in the PO_FX_DEVICE structure that the device driver used to register the device with PoFx. If the Components array contains N elements, component indexes range from 0 to N–1.

Return value

None

Remarks

After PoFx calls the driver's ComponentIdleStateCallback callback routine, the driver must respond by calling PoFxCompleteIdleState.

PoFx calls the driver's ComponentIdleStateCallback routine to tell the driver to switch the specified component to a new Fx power state. After the driver completes the transition to the new Fx state, the driver calls PoFxCompleteIdleState to inform PoFx. The PoFxCompleteIdleState call can occur either during or after the ComponentIdleStateCallback call.

Requirements

Requirement	Value
Minimum supported client	Available starting with Windows 8.
Target Platform	Universal
Header	wdm.h
Library	Ntoskrnl.lib
DLL	Ntoskrnl.exe
IRQL	<= DISPATCH_LEVEL