SetProcessPriorityBoost
[New
- Windows NT]
The SetProcessPriorityBoost
function disables the ability of Windows NT to temporarily boost the priority
of the threads of the specified process.
BOOL SetProcessPriorityBoost(
HANDLE hProcess, |
// handle to process |
BOOL DisablePriorityBoost |
// priority boost control state |
); |
|
Parameters
hProcess
Handle to the
process. This handle must have the PROCESS_SET_INFORMATION access right. For
more information, see Process Objects
DisablePriorityBoost
A Boolean
variable that is used to set the priority boost control state. A value of TRUE
indicates that dynamic boosting is to be disabled. A value of FALSE restores
normal behavior.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError
Remarks
When a thread
is running in one of the dynamic priority classes, Windows NT temporarily
boosts the thread s priority when it is taken out of a wait state. If SetProcessPriorityBoost
is called with the DisablePriorityBoost parameter set to TRUE, its
threads priorities are not boosted. This setting affects all existing threads
and any threads subsequently created by the process. To restore normal
behavior, call SetProcessPriorityBoost with DisablePriorityBoost
set to FALSE.
See Also