Функция SetProcessPriorityBoost


Функция SetProcessPriorityBoost отключает или включает способность системы временно повышать приоритет потоков заданного процесса.

Синтаксис

BOOL SetProcessPriorityBoost(
HANDLE hProcess,          // дескриптор процесса
BOOL DisablePriorityBoost // состояние форсированного приоритета
);

Параметры

hProcess

[in] Дескриптор процесса. Этот дескриптор должен иметь право доступа PROCESS_SET_INFORMATION. Для получения дополнительной информации, см. статью Защита процесса и права доступа.

DisablePriorityBoost

[in] Если этот параметр имеет значение ИСТИНА (TRUE), то динамический форсаж блокируется. Если этот параметр имеет значение ЛОЖЬ (FALSE), то динамический форсаж разрешается.

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

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

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

Замечания

Когда поток запускается в одном из классов динамического приоритета, система временно повышает приоритет потока, чтобы вывести его из состояния ожидания. Если функция SetProcessPriorityBoost вызывается с параметром DisablePriorityBoost установленным в значение ИСТИНА (TRUE), приоритеты потоков не повышаются. Этот параметр воздействует на все существующие потоки и любые потоки, впоследствии созданные процессом. Чтобы восстанавливать нормальный режим работы, вызовите SetProcessPriorityBoost с параметром DisablePriorityBoost установленным в ЛОЖЬ (FALSE).

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, GetProcessPriorityBoost

Размещение и совместимость SetProcessPriorityBoost

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 4.0 и выше

Windows Me

Нет

Windows 98

Нет

Windows 95

Нет

Используемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz