StorPortInitializePoFxPower 函式 (storport.h)

  • 發行項

迷你埠驅動程式會呼叫 StorPortInitializePoFxPower ，以向電源管理架構註冊存放裝置， (PoFx) 。

語法

ULONG StorPortInitializePoFxPower(
  [in]           PVOID             HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS     Address,
  [in]           PSTOR_POFX_DEVICE Device,
  [in, out]      PBOOLEAN          D3ColdEnabled
);

參數

[in] HwDeviceExtension

主機匯流排介面卡的硬體裝置擴充功能指標， (HBA) 。

[in, optional] Address

儲存裝置單位的位址。 註冊儲存體配接器時，此參數為 Null 。

[in] Device

STOR_POFX_DEVICE_V2結構的指標，轉換成STOR_POFX_DEVICE的指標。 此結構包含具有儲存裝置 F 狀態的元件清單。

[in, out] D3ColdEnabled

Storport 驅動程式將設定為指出儲存體裝置是否啟用 D3 冷狀態的 BOOLEAN 值指標。

傳回值

StorPortInitializePoFxPower常式會傳回下列其中一個狀態碼：

傳回碼 描述
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension或Device為 Null。

-或-

位址 指向不正確單位位址結構。

-或-

找不到 Address 所指定的儲存裝置。

-或-

裝置所指向的STOR_POFX_DEVICE結構格式不正確，或包含不正確資料。
STOR_STATUS_SUCCESS
 儲存體裝置已成功向 PoFx 註冊。
STOR_STATUS_INSUFFICIENT_RESOURCES
 沒有足夠的資源無法向 PoFx 註冊存放裝置。
STOR_STATUS_UNSUCCESSFUL
 儲存體裝置未成功向 PoFx 註冊。

-或-

儲存體裝置已向 PoFx 註冊。

備註

配接器裝置一律會向位址的Null值註冊。 單位裝置是藉由指定 位址的有效單位位址來註冊。

如果在裝置的Flags成員中設定STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD旗標，Storport 會嘗試啟用裝置元件的 D3 冷支援。 D3 冷啟用狀態會在D3ColdEnabled所指向的BOOLEAN值中傳回。

必要條件

   
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 環球
標頭 storport.h

另請參閱

STOR_POFX_DEVICE