D3 Cold for Storport miniport

Mark ...

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

A miniport driver calls Storportinitializepofxpower to register a storage device with the power management Framew Ork (POFX). Syntax C++

ULONG storportinitializepofxpower (
  _in_ PVOID hwdeviceextension,
  _in_opt_ pstor_address ADDRESS,
  _in_ Pstor_pofx_device DEVICE,
  _inout_ pboolean d3coldenabled
);

ParametersHwdeviceextension [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 if 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 the f-states for a storage device. d3coldenabled [in, out]

A pointer to a BOOLEAN value which the Storport driver would set to indicate whether the D3 Cold state is enabled For the storage device. Return Value

The storportinitializepofxpower routine returns one of the These status codes:

Return Code	Description
Stor_status_invalid_parameter	Either Hwdeviceextension or Device is NULL. -or- Address points to an invalid unit address structure. -or- The storage device specified by Address was not found. -or- The Stor_pofx_device structure pointed to by DEVICE is formatted incorrectly or contains invalid data.
stor_status_success	The storage device is successfully registered with POFX.
stor_status_insufficient_resources	Sufficient resources is not available to register the storage device with POFX.
stor_status_unsuccessful	The storage device is not a successfully registered with POFX. -or- The storage device is a already registered with POFX.

Remarks

Adapter devices is always registered with a NULL value for address. Unit devices is 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'll att Empt to enable D3 Cold support for the device component. The D3 Cold enabled status is returned in the BOOLEAN value pointed through d3coldenabled. Requirements

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

See also Stor_pofx_device