PoFxCompleteIdleCondition function (wdm.h)

Article
02/22/2024

The PoFxCompleteIdleCondition routine informs the power management framework (PoFx) that the specified component has completed a pending change to the idle condition.

Syntax

void PoFxCompleteIdleCondition(
  [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 ComponentIdleConditionCallback callback routine, the driver must respond by calling PoFxCompleteIdleCondition.

When PoFx calls the driver's ComponentIdleConditionCallback routine, the driver initiates a transition to the idle condition in the specified component. After this transition is complete, the driver calls PoFxCompleteIdleCondition to notify PoFx. The PoFxCompleteIdleCondition call can occur either during or after the ComponentIdleConditionCallback 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