EVT_WDF_DEVICE_POWER_POLICY_STATE_CHANGE_NOTIFICATION callback function (wdfdevice.h)
[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 |