StorPortInitializePoFxPower routine

A miniport driver calls StorPortInitializePoFxPower to register a storage device with the power management framework (PoFx).


ULONG StorPortInitializePoFxPower(
  _In_     PVOID             HwDeviceExtension,
  _In_opt_ PSTOR_ADDRESS     Address,
  _In_     PSTOR_POFX_DEVICE Device,
  _Inout_  PBOOLEAN          D3ColdEnabled


HwDeviceExtension [in]

A pointer to the hardware device extension for the host bus adapter (HBA).

Address [in, optional]

The address of a storage device unit. This parameter is NULL when registering for a storage adapter.

Device [in]

A pointer to a STOR_POFX_DEVICE_V2 structure cast to a pointer to STOR_POFX_DEVICE. This structure contains a component list with F-states for a storage device.

D3ColdEnabled [in, out]

A pointer to a BOOLEAN value which the Storport driver will set to indicate whether the D3 Cold state is enabled for the storage device.

Return value

The StorPortInitializePoFxPower routine returns one of these status codes:

Return codeDescription

Either HwDeviceExtension or Device is NULL.


Address points to an invalid unit address structure.


The storage device specified by Address is not found.


The STOR_POFX_DEVICE structure pointed to by Device is formatted incorrectly or contains invalid data.


The storage device was successfully registered with PoFx.


Sufficient resources are not available to register the storage device with PoFx.


The storage device was not successfully registered with PoFx.


The storage device is already registered with PoFx.



Adapter devices are always registered with a NULL value for address. Unit devices are registered by specifying a valid unit address for address.

If the STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD flag is set in the Flags member of Device, Storport will attempt to enable D3 Cold support for the device component. The D3 Cold enabled status is returned in the BOOLEAN value pointed to by D3ColdEnabled.


Target platform


Available in starting with Windows 8.



See also




Send comments about this topic to Microsoft