PoFxCompleteIdleState function (wdm.h)

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

See also

ComponentIdleStateCallback

PO_FX_DEVICE

PoFxRegisterDevice