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

Статья
08/25/2023

Перечисляет указанные элементы в схеме управления питанием. Обычно эта функция вызывается в цикле, который увеличивает параметр Index для получения подразделов, пока они не будут перечислены.

Синтаксис

DWORD PowerEnumerate(
  [in, optional]  HKEY                RootPowerKey,
  [in, optional]  const GUID          *SchemeGuid,
  [in, optional]  const GUID          *SubGroupOfPowerSettingsGuid,
  [in]            POWER_DATA_ACCESSOR AccessFlags,
  [in]            ULONG               Index,
  [out, optional] UCHAR               *Buffer,
  [in, out]       DWORD               *BufferSize
);

Параметры

[in, optional] RootPowerKey

Этот параметр зарезервирован для использования в будущем и должен иметь значение NULL.

[in, optional] SchemeGuid

Идентификатор схемы питания. Если этот параметр имеет значение NULL, возвращается перечисление политик управления питанием.

[in, optional] SubGroupOfPowerSettingsGuid

Подгруппа параметров питания. Если этот параметр имеет значение NULL, возвращается перечисление параметров в разделе PolicyGuid .

Значение	Значение
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] AccessFlags

Набор флагов, указывающий, что будет перечислено.

Значение	Значение
ACCESS_SCHEME 16	Перечисление схем питания. Параметры SchemeGuid и SubgroupOfPowerSettingsGuid будут игнорироваться.
ACCESS_SUBGROUP 17	Перечисление подгрупп в разделе SchemeGuid. Параметр SubgroupOfPowerSettingsGuid будет игнорироваться.
ACCESS_INDIVIDUAL_SETTING 18	Перечислите отдельные параметры питания в разделе SchemeGuid\SubgroupOfPowerSettingsGuid. Чтобы перечислить параметры питания непосредственно в ключе SchemeGuid , используйте NO_SUBGROUP_GUID в качестве параметра SubgroupOfPowerSettingsGuid .

[in] Index

Отсчитываемый от нуля индекс схемы, подгруппы или параметра, которые перечисляются.

[out, optional] Buffer

Указатель на переменную для получения элементов. Если этот параметр имеет значение NULL, функция извлекает требуемый размер буфера.

[in, out] BufferSize

Указатель на переменную, которая на входных данных содержит размер буфера, на который указывает параметр Buffer . Если параметр Buffer имеет значение NULL или bufferSize недостаточно велик, функция возвращает ERROR_MORE_DATA , а переменная получает требуемый размер буфера.

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

Возвращает ERROR_SUCCESS (ноль), если вызов был выполнен успешно, и ненулевое значение, если вызов завершился неудачно. Если размер буфера, передаваемый в параметре BufferSize , слишком мал или параметр Buffer имеет значение NULL, возвращается ERROR_MORE_DATA , а параметр DWORD , на который указывает параметр BufferSize , будет заполнен требуемым размером буфера.

Требования

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

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

POWER_DATA_ACCESSOR

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

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