Edit

EVT_WDF_DEVICE_POWER_POLICY_STATE_CHANGE_NOTIFICATION callback function (wdfdevice.h)

  • Article

[Applies to KMDF only]

Note

This callback function is for Microsoft-internal use only.

A driver's EvtDevicePowerPolicyStateChange event callback function informs the driver that a device's power policy state machine is moving from one state to another.

Syntax

EVT_WDF_DEVICE_POWER_POLICY_STATE_CHANGE_NOTIFICATION EvtWdfDevicePowerPolicyStateChangeNotification;

void EvtWdfDevicePowerPolicyStateChangeNotification(
  [in] WDFDEVICE Device,
  [in] PCWDF_DEVICE_POWER_POLICY_NOTIFICATION_DATA NotificationData
)
{...}

Parameters

[in] Device

A handle to a framework device object.

[in] NotificationData

A pointer to a framework-supplied WDF_DEVICE_POWER_POLICY_NOTIFICATION_DATA structure that identifies the state machine's old and new states.

Return value

None

Remarks

To register an EvtDevicePowerPolicyStateChange callback function, a driver must call WdfDeviceInitRegisterPowerPolicyStateChangeCallback.

For more information, see State Machines in the Framework.

If the EvtDevicePowerPolicyStateChange callback function calls WdfDeviceStopIdle with the WaitForD0 parameter set to TRUE, the framework's power policy state machine will become deadlocked.

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Header wdfdevice.h (include Wdf.h)
IRQL PASSIVE_LEVEL

See also

EvtDevicePnpStateChange

EvtDevicePowerStateChange