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

Подпрограмма StorPortSetPowerSettingNotificationGuids позволяет минипорту получать уведомления о параметрах питания. Минипорт регистрирует массив графических идентификаторов, определяющих параметры питания для получения уведомлений об изменении питания.

Синтаксис

ULONG StorPortSetPowerSettingNotificationGuids(
  [in] PVOID  HwDeviceExtension,
  [in] ULONG  GuidCount,
  [in] LPGUID Guid
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).

[in] GuidCount

Количество идентификаторов GUID в массиве guid guid.

[in] Guid

Массив идентификаторов GUID параметров питания для регистрации для уведомления. Типичным способом регистрации этих графических идентификаторов является мини-порты SATA для получения уведомлений об изменениях параметров управления питанием AHCI Link. Параметры AHCI Link Power Management, определенные драйвером минипорта Microsoft AHCI StorPort, приведены ниже.

Параметр 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 (include Storport.h)
IRQL	Любой

См. также

HwStorAdapterControl

HwStorFindAdapter