Функция PowerReadSettingAttributes (powrprof.h)

Статья
03/01/2024

Возвращает текущий атрибут указанного параметра питания. Если параметр SubGroupGuid имеет значение NULL , возвращается атрибут для PowerSettingGuid . Если параметр PowerSettingGuid имеет значение NULL , возвращается атрибут SubGroupGuid . Если параметры SubGroupGuid и PowerSettingGuid являются допустимыми, то возвращаемое значение представляет собой сочетание (побитовой или) атрибутов подгруппы и параметра питания.

Синтаксис

DWORD PowerReadSettingAttributes(
  [in] const GUID *SubGroupGuid,
  [in] const GUID *PowerSettingGuid
);

Параметры

[in] SubGroupGuid

Подгруппа параметров питания. Этот параметр может быть одним из следующих значений, определенных в WinNT.h. Используйте NO_SUBGROUP_GUID для ссылки на схему питания по умолчанию.

Эти значения являются значениями подгрупп, включенными в Windows.

Значение	Значение
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1c294	Параметры в этой подгруппе являются частью схемы питания по умолчанию.
GUID_DISK_SUBGROUP 0012ee47-9041-4b5d-9b77-535fba8b1442	Параметры в этой подгруппе управляют конфигурацией управления питанием жестких дисков системы.
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	Параметры в этой подгруппе управляют конфигурацией системных кнопок питания.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	Параметры в этой подгруппе управляют конфигурацией функций управления питанием процессора.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	Параметры в этой подгруппе управляют конфигурацией функций управления питанием видео.
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	Параметры в этой подгруппе управляют точками и действиями сигнала о срабатывании батареи.
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	Параметры в этой подгруппе управляют параметрами спящего режима системы.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	Параметры в этой подгруппе управляют параметрами PCI Express.

[in] PowerSettingGuid

Идентификатор используемого параметра питания.

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

Возвращает атрибуты текущего параметра питания указанного параметра питания. Атрибут представляет собой сочетание атрибутов параметра power и атрибутов его подгруппы.

Возвращаемый код или значение	Описание
POWER_ATTRIBUTE_HIDE 1	Скрыть этот параметр питания.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	powrprof.h
Библиотека	PowrProf.lib
DLL	PowrProf.dll

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

Функции управления питанием

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