STOR_POFX_DEVICE_V2 - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// storport.h
typedef struct _STOR_POFX_DEVICE_V2 {
ULONG Version;
ULONG Size;
ULONG ComponentCount;
ULONG Flags;
union {
ULONG UnitMinIdleTimeoutInMS;
ULONG AdapterIdleTimeoutInMS;
};
STOR_POFX_COMPONENT Components[ANYSIZE_ARRAY];
} STOR_POFX_DEVICE_V2, *PSTOR_POFX_DEVICE_V2;
View the official Windows Driver Kit DDI referenceNo description available.
The STOR_POFX_DEVICE_V2 structure describes the power attributes of a storage device to the power management framework (PoFx). This structure is similar to STOR_POFX_DEVICE but contains additional timeout settings.
VersionThe version number of this structure. Set this member to STOR_POFX_DEVICE_VERSION_V2.
SizeThe size of this structure. Set this value to STOR_POFX_DEVICE_SIZE.
ComponentCountThe number of elements in the Components array. Set this member to 1. Currently, only a single component is supported for either a storage adapter or logical unit.
FlagsThe device power state capabilities flags. The miniport sets one or more of the PoFx device flags to enable or disable power state capabilities.
Flags is a bitwise OR combination of the following.
| Value | Meaning |
|---|---|
| STOR_POFX_DEVICE_FLAG_NO_D0 | Requests that a power up IRP not be sent to the device object for the adapter or unit. |
| STOR_POFX_DEVICE_FLAG_NO_D3 | Requests that a power down IRP not be sent to the device object for the adapter or unit. |
| STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD | Enables Storport to set the D3 Cold state for the adapter if it supports it. This flag applies to adapters only. |
| STOR_POFX_DEVICE_FLAG_NO_DUMP_ACTIVE | The miniport is not able to bring the storage device active in dump mode if the device has entered the idle state or the power off when idle state. This flag indicates whether a device is available for dump when it is idle. |
| STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT | The timeout value in UnitMinIdleTimeoutInMS or AdapterIdleTimeoutInMS is used for the D3 idle timeout. |
UnitMinIdleTimeoutInMSThe minimum idle time in milliseconds for an unit. This value is only valid when STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT is set in Flags.
AdapterIdleTimeoutInMSThe adapter idle timeout value in milliseconds. This value is only valid when STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT is set in Flags.
ComponentsThis member is the first element in an array of one or more STOR_POFX_COMPONENT elements. If the array contains more than one element, the additional elements immediately follow the STOR_POFX_DEVICE structure. The array contains one element for each component in the device. Currently, storage devices have only one component so additional component structures are unnecessary.
To register a storage adapter for Storport PoFx support, the miniport driver calls StorPortEnablePassiveInitialization in its HwStorInitialize routine and implements a HwStorPassiveInitializeRoutine. The miniport calls StorPortInitializePoFxPower within it's HwStorPassiveInitializeRoutine to provide information about the adapter component.
To register a storage unit for Storport PoFx support, the miniport driver implements the HwStorUnitControl callback routine and provides handling of the ScsiUnitPoFxPowerInfo unit control code. When the handling the ScsiUnitPoFxPowerInfo control code, the miniport calls StorPortInitializePoFxPower if idle power management for the unit component is enabled.
The component for the storage device identified by its Components array index. Storage devices have only one component so the index of 0 is used. Routines such as StorPortPoFxActivateComponent and StorPortPoFxIdleComponent use the array index of a component to identify the component.