PoFxCompleteIdleCondition function (wdm.h)

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

See also

ComponentIdleConditionCallback

PO_FX_DEVICE

PoFxRegisterDevice