Share via

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 链接电源管理设置更改的通知。 Microsoft AHCI StorPort 微型端口驱动程序定义的 AHCI 链接电源管理设置如下所示。

HIPM/DIPM 设置 (0b2d69d7-a2a1-449c-9680-f91c70521c60)

为通过 AHCI 接口连接到系统的磁盘和存储设备配置链接电源管理模式。

索引 名称 说明
0 可用 未使用链接电源管理。
1 HIPM 使用主机启动电源管理 (HIPM)。
2 HIPM 和 DIPM 使用 HIPM 和设备启动电源管理 (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 Link 电源管理设置是电源策略配置中的磁盘设置子组 (0012ee47-9041-4b5d-9b77-535fba8b1442) 的一部分。 这些在SUB_DISK配置别名下使用 powercfg.exe进行管理。

要求

要求 值
最低受支持的客户端 从 Windows 8 开始可用。
目标平台 通用
标头 storport.h (包括 Storport.h)
IRQL 任意

另请参阅

HwStorAdapterControl

HwStorFindAdapter