共用方式為

StorPortSetPowerSettingNotificationGuids 函式 （storport.h）

  • 發行項

StorPortSetPowerSettingNotificationGuids 例程可讓迷你埠接收電源設定通知。 迷你埠會註冊 GUID 陣列，以識別要接收電源變更通知的電源設定。

語法

ULONG StorPortSetPowerSettingNotificationGuids(
  [in] PVOID  HwDeviceExtension,
  [in] ULONG  GuidCount,
  [in] LPGUID Guid
);

參數

[in] HwDeviceExtension

主機總線適配卡 （HBA） 的硬體裝置擴充功能指標。

[in] GuidCount

Guid 陣列中的 GUID 數目。

[in] Guid

要註冊通知的電源設定 GUID 陣列。 註冊這些 GUID 的一般用途是讓 SATA 迷你埠接收 AHCI Link 電源管理設定變更的通知。 Microsoft AHCI StorPort 迷你埠驅動程式所定義的 AHCI 鏈接電源管理設定如下。

HIPM/DIPM 設定 （0b2d69d7-a2a1-449c-9680-f91c70521c60）

針對透過 AHCI 介面連結至系統的磁碟和儲存裝置設定連結電源管理模式。

指數 名字 描述
0 積極 未使用連結電源管理。
1 HIPM Host-Initiated 電源管理 （HIPM） 使用。
2 HIPM 和 DIPM 使用HIPM和 Device-Initiated 電源管理 （DIPM）。
 

調適型設定 （dab60367-53fe-4fbc-825e-521d069d2456）

啟用HIPM或DIPM時，鏈接進入沉睡狀態之前，AHCI 連結空閒時間的期間。

價值 描述
0 毫秒的最小值（僅使用部分狀態）。
... 任何中繼值。
300000 以毫秒為單位的最大值（5 分鐘）。
 

其他迷你埠可以定義並註冊自己的電源設定 GUID。

傳回值

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

傳回碼 描述
STOR_STATUS_INSUFFICIENT_RESOURCES
 資源不足，無法註冊通知。
STOR_STATUS_SUCCESS
 已成功註冊通知 GUID。

言論

迷你埠會在其 HwStorFindAdapter 例程中呼叫 StorPortSetPowerSettingNotificationGuids，以註冊它要求接收通知的 GUID。

註冊通知發生電源狀態變更時，迷你埠會在其 HwStorAdapterControl 例程中收到通知。 ScsiPowerSettingNotification 的控件類型是在 controlType 參數 設定。

AHCI 鏈接電源管理設定是電源原則設定中磁碟設定子群組 （0012ee47-9041-4b5d-9b77-535fba8b1442） 的一部分。 這些是在具有 powercfg.exe的SUB_DISK組態別名下管理。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 普遍
標頭 storport.h （包括 Storport.h）
IRQL 任何

另請參閱

HwStorAdapterControl

HwStorFindAdapter