Функция SetProcessPriorityBoost (processthreadsapi.h)

  • Статья

Отключает или включает возможность системы временно повысить приоритет потоков указанного процесса.

Синтаксис

BOOL SetProcessPriorityBoost(
  [in] HANDLE hProcess,
  [in] BOOL   bDisablePriorityBoost
);

Параметры

[in] hProcess

Дескриптор процесса. Этот дескриптор должен иметь право доступа PROCESS_SET_INFORMATION. Дополнительные сведения см. в разделе Обработка прав на безопасность и доступ.

[in] bDisablePriorityBoost

Если этот параметр имеет значение TRUE, динамическое повышение отключено. Если параметр имеет значение FALSE, включено динамическое повышение.

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

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

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

Комментарии

Когда поток выполняется в одном из классов динамического приоритета, система временно повышает приоритет потока при выходе из состояния ожидания. Если метод SetProcessPriorityBoost вызывается с параметром DisablePriorityBoost , равным TRUE, приоритеты его потоков не повышаются. Этот параметр влияет на все существующие потоки и все потоки, впоследствии созданные процессом. Чтобы восстановить нормальное поведение, вызовите SetProcessPriorityBoost , а для параметра DisablePriorityBoost задано значение FALSE.

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header processthreadsapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

GetProcessPriorityBoost

Повышение приоритета

Функции процессов и потоков

Процессы

Приоритеты планирования