Функция StorPortSetPowerSettingNotificationGuids (storport.h)

Статья
03/01/2024

Подпрограмма 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. Ниже приведены параметры управления питанием канала AHCI, определенные драйвером microsoft AHCI StorPort miniport.

Параметры 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)

Период простоя канала AHCI до того, как ссылка будет переведена в состояние сна при включении HIPM или DIPM.

Значение	Описание
0	Минимальное значение в миллисекундах (используйте только частичное состояние).
...	Любое промежуточное значение.
300000	Максимальное значение в миллисекундах (5 минут).

Другие минипорты могут определять и регистрировать собственные GUID параметров питания.

Возвращаемое значение

Подпрограмма StorPortSetPowerSettingNotificationGuids возвращает один из следующих кодов состояния:

Код возврата	Описание
STOR_STATUS_INSUFFICIENT_RESOURCES	Недостаточно ресурсов для регистрации уведомлений.
STOR_STATUS_SUCCESS	Идентификаторы GUID уведомлений успешно зарегистрированы.

При изменении состояния питания для зарегистрированного уведомления минипорт получает уведомление в своей подпрограмме HwStorAdapterControl . Тип элемента управления ScsiPowerSettingNotification задается в параметре ControlType .

Параметры управления питанием канала AHCI входят в подгруппу Параметры диска (0012ee47-9041-4b5d-9b77-535fba8b1442) в конфигурации политики питания. Они управляются под псевдонимом конфигурации SUB_DISK с помощьюpowercfg.exe.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.
Целевая платформа	Универсальное
Верхняя часть	storport.h (включая Storport.h)
IRQL	Любой

См. также раздел

HwStorAdapterControl

HwStorFindAdapter

Share via