D3 cold for storport miniport

Mark...

Http://msdn.microsoft.com/en-us/library/windows/hardware/hh920421 (V = vs.85). aspx

A miniport driver CILSStorportinitializepofxpowerTo register a storage device with the power management framework (pofx ).

Syntaxc ++

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

Parameters

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 isNullWhen registering for a storage adapter.

Device[In]

A pointer toStor_pofx_device_v2Structure cast to a pointerStor_pofx_device.
This structure contains a component list with F-States for a storage device.

D3coldenabled[In, out]

A pointer toBooleanValue which the storport driver will set to indicate whether the D3 cold state is enabled for the storage device.

Return Value

TheStorportinitializepofxpowerRoutine returns one of these status codes:

Return code	Description
Stor_status_invalid_parameter	EitherHwdeviceextensionOrDeviceIs null. -Or- AddressPoints to an invalid unit address structure. -Or- The storage device specifiedAddressIs not found. -Or- TheStor_pofx_deviceStructure pointed ToDeviceIs formatted incorrectly or contains invalid data.
Stor_status_success	The storage device was successfully registered with pofx.
Stor_status_insufficient_resources	Sufficient resources are not available to register the storage device with pofx.
Stor_status_unsuccessful	The storage device was not successfully registered with pofx. -Or- The storage device is already registered with pofx.

 

Remarks

Adapter devices are always registered withNullValueAddress. Unit devices are registered by specifying a valid unit addressAddress.

IfStor_pofx_device_flag_enable_d3_coldFlag is set inFlagsMemberDevice, Storport will attempt to enable D3 cold support for the device component. The D3 cold enabled status is returned inBooleanValue
Pointed toD3coldenabled.

Requirements

Version	Available in starting with Windows 8.
Header	Storport. h

See also

Stor_pofx_device