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 Link 電源管理設定如下。

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

索引	名稱	描述
0	使用中	未使用連結電源管理。
1	HIPM	Host-Initiated 使用 POWER Management (HIPM) 。
2	HIPM 和 DIPM	會使用HIPM和 Device-Initiated 電源管理 (DIPM) 。

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

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

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

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

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

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

AHCI Link 電源管理設定是磁碟設定子群組的一部分， (0012ee47-9041-4b5d-9b77-535fba8b1442) 。這些是使用 powercfg.exeSUB_DISK 組態別名來管理。