通过

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 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 例程中收到通知。 ControlType 参数中设置 ScsiPowerSettingNotification 的控件类型。

AHCI 链接电源管理设置是电源策略配置中的磁盘设置子组（0012ee47-9041-4b5d-9b77-535fba8b1442）的一部分。 这些在SUB_DISK配置别名下使用 powercfg.exe进行管理。

要求

要求 价值
最低支持的客户端 从 Windows 8 开始可用。
目标平台 普遍
标头 storport.h （包括 Storport.h）
IRQL 任何

另请参阅

HwStorAdapterControl

HwStorFindAdapter