Функция GetPwrCapabilities (powerbase.h)

Извлекает сведения о возможностях питания системы.

Синтаксис

BOOLEAN GetPwrCapabilities(
  [out] PSYSTEM_POWER_CAPABILITIES lpspc
);

Параметры

[out] lpspc

Указатель на структуру SYSTEM_POWER_CAPABILITIES , которая получает сведения.

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

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Эта функция получает подробные сведения о текущих ресурсах и возможностях оборудования для управления питанием системы. Сюда входят сведения о наличии аппаратных функций, таких как кнопки питания, выключатели крышки и батареи. Другие возвращаемые сведения включают сведения о текущих возможностях управления питанием и конфигурациях, которые могут динамически изменяться, например минимальное поддерживаемое в настоящее время состояние спящего режима, которое может измениться по мере внедрения новых драйверов в систему, или наличие файла гибернации системы.

Эти сведения также доступны через функцию CallNtPowerInformation , используя уровень SystemPowerCapabilities.

Дополнительные сведения об использовании PowrProf.h см. в разделе Схемы питания.

Требования

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

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

CallNtPowerInformation

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

SYSTEM_POWER_CAPABILITIES