PoFxCompleteDevicePowerNotRequired function (wdm.h)

Article
02/22/2024

The PoFxCompleteDevicePowerNotRequired routine notifies the power management framework (PoFx) that the calling driver has completed its response to a call to the driver's DevicePowerNotRequiredCallback callback routine.

Syntax

void PoFxCompleteDevicePowerNotRequired(
  [in] POHANDLE Handle
);

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.

Return value

None

Remarks

After PoFx calls the driver's DevicePowerNotRequiredCallback callback routine, the driver must respond by calling PoFxCompleteDevicePowerNotRequired.

PoFx calls the driver's DevicePowerNotRequiredCallback routine to inform the driver that the device is no longer required to remain in the D0 state. In response to this call, the driver can choose to enter a low-power Dx state or to remain in the D0 state. After the driver has completed its response to the DevicePowerNotRequiredCallback call, the driver calls PoFxCompleteDevicePowerNotRequired to inform PoFx. The PoFxCompleteDevicePowerNotRequired call can occur either during or after the DevicePowerNotRequiredCallback 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