Функция PowerClearRequest (winbase.h)

Статья
03/03/2024

Уменьшает количество запросов на питание указанного типа для объекта запроса питания.

Синтаксис

BOOL PowerClearRequest(
  [in] HANDLE             PowerRequest,
  [in] POWER_REQUEST_TYPE RequestType
);

Параметры

[in] PowerRequest

Дескриптор объекта запроса питания.

[in] RequestType

Тип запроса на питание, который необходимо уменьшать. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
PowerRequestDisplayRequired	Дисплей остается в состоянии, даже если пользователь не вводит данные в течение длительного периода времени.
PowerRequestSystemRequired	Система продолжает работать, а не входить в спящий режим после периода бездействия пользователя.
PowerRequestAwayModeRequired	Система переходит в режим "вне", а не в спящий режим. В автономном режиме система продолжает работать, но отключает звук и видео, чтобы придать вид спящего режима.
PowerRequestExecutionRequired	Вызывающий процесс продолжает выполняться, а не приостанавливается или прерывается механизмами управления жизненным циклом процессов. Время и время выполнения процесса зависит от параметров операционной системы и политики управления питанием. Если запрос PowerRequestExecutionRequired активен, он подразумевает powerRequestSystemRequired. Тип запроса PowerRequestExecutionRequired может использоваться только приложениями. Службы не могут использовать этот тип запроса. Windows 7 и Windows Server 2008 R2: Этот тип запроса поддерживается начиная с Windows 8 и Windows Server 2012.

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

PowerCreateRequest

PowerSetRequest

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