共用方式為

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

BOOLEAN 值的指標，Storport 驅動程式會設定為指出是否為存儲設備啟用 D3 冷狀態。

傳回值

StorPortInitializePoFxPower 例程會傳回下列其中一個狀態代碼：

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

-或-

位址 指向無效的單位地址結構。

-或-

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

-或-

Device 所指向 STOR_POFX_DEVICE 結構的格式不正確或包含無效的數據。
STOR_STATUS_SUCCESS
 已成功向PoFx註冊儲存設備。
STOR_STATUS_INSUFFICIENT_RESOURCES
 沒有足夠的資源可用來向PoFx註冊存儲設備。
STOR_STATUS_UNSUCCESSFUL
 記憶體裝置未成功向PoFx註冊。

-或-

存儲設備已向PoFx註冊。

言論

適配卡裝置一律會向 位址註冊 NULL 值。 單位裝置會藉由指定 位址的有效單位位址來註冊。

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

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 普遍
標頭 storport.h

另請參閱

STOR_POFX_DEVICE