This IRP returns the power sequence values for a device.
A driver sends this IRP as an optimization to determine whether its device actually entered a specific power state. Support for this IRP is optional.
To send this IRP, a driver must call IoAllocateIrp to allocate the IRP, specifying the major IRP code IRP_MJ_POWER and minor IRP code IRP_MN_POWER_SEQUENCE. The driver must then call IoCallDriver (Windows Vista) or PoCallDriver (Windows Server 2003, Windows XP, and Windows 2000) to pass the IRP to the next lower driver. The power manager cannot send this IRP.
Senders of this IRP must be running at IRQL <= DISPATCH_LEVEL.
Parameters.PowerSequence points to a POWER_SEQUENCE structure with the following members:
The sequence values track the minimum number of times a device has been in the corresponding power state or a lower power state.
The bus driver increments the values in SequenceD1, SequenceD2, and SequenceD3 at least each time the device enters in the corresponding power state or a lower power state.
I/O Status Block
A driver sets Irp->IoStatus.Status to STATUS_SUCCESS to indicate that it has returned the requested information, or to STATUS_NOT_IMPLEMENTED to indicate that it does not support this IRP.
This IRP returns the power sequence values for a device. Bus drivers can optionally handle it; function and filter drivers can optionally send it.
For a device that takes a long time to change state, this IRP provides a useful optimization. Every time the device changes its power state, its bus driver increments the sequence value for that power state. The bus driver initializes the sequence values at boot time and continually increments them thereafter; they need not be reset to zero.
A device policy owner can send this IRP once to get the sequence values before shutting off the device and once again to get new values when restoring power to the device. By comparing the two sets of values, the driver can determine whether the device actually entered the lower-powered state. If the device did not lose power, the driver can avoid a time-consuming reinitialization when the device returns to the D0 state.
For example, if the device takes a long time to restore power upon reaching the D2 state, the driver can store the SequenceD2 value before it sets the device state to D2 or lower. Later, when power is being restored to the device, the driver can compare the new SequenceD2 value with its stored value to determine whether the device state actually dropped below D2. If the values match, the device did not actually enter power state D2 or a lower state, and the driver can avoid reinitializing the device.
|Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)|