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

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

  • Статья

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

Синтаксис

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