Поделиться через


Функция 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. Ниже приведены параметры управления питанием канала 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 уведомлений успешно зарегистрированы.

Комментарии

Мини-порт вызывает StorPortSetPowerSettingNotificationGuids в своей подпрограмме HwStorFindAdapter , чтобы зарегистрировать guid, для которого он запрашивает получение уведомлений.

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

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

Требования

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

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

HwStorAdapterControl

HwStorFindAdapter