state-machines-in-the-framework.md

title	description	keywords	ms.date
State Machines in the Framework	State Machines in the Framework	PnP WDK KMDF , state machines Plug and Play WDK KMDF , state machines power management WDK KMDF , state machines state machines WDK KMDF states WDK KMDF PnP state machines WDK KMDF power states WDK KMDF current state machine state WDK KMDF status information WDK KMDF , state machines power policy WDK KMDF	04/20/2017

State Machines in the Framework

To keep track of each device's state, the framework uses a PnP state machine, a power state machine, and a power policy state machine. The framework creates an instance of each state machine for each device that is plugged into a system.

Note

This functionality is for Microsoft-internal use only.

For drivers that do need to know this information, the framework provides two sets of interfaces:

• A set of driver-supplied event callback functions.

  The driver can request that the framework call one of the following callback functions whenever one of the state machines enters or exits a particular state:

  • EvtDevicePnpStateChange, which the driver registers by calling WdfDeviceInitRegisterPnpStateChangeCallback.
  • EvtDevicePowerStateChange, which the driver registers by calling WdfDeviceInitRegisterPowerStateChangeCallback.
  • EvtDevicePowerPolicyStateChange, which the driver registers by calling WdfDeviceInitRegisterPowerPolicyStateChangeCallback.

• A set of methods that return the current state of the state machines.

  The driver can call one of the following methods to determine the current state of one of the state machines for a particular device:

  • WdfDeviceGetDevicePnpState
  • WdfDeviceGetDevicePowerState
  • WdfDeviceGetDevicePowerPolicyState