Process.PriorityBoostEnabled Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets a value indicating whether the associated process priority should temporarily be boosted by the operating system when the main window has the focus.
public:
property bool PriorityBoostEnabled { bool get(); void set(bool value); };
public bool PriorityBoostEnabled { get; set; }
member this.PriorityBoostEnabled : bool with get, set
Public Property PriorityBoostEnabled As Boolean
Property Value
true
if dynamic boosting of the process priority should take place for a process when it is taken out of the wait state; otherwise, false
. The default is false
.
Exceptions
Priority boost information could not be retrieved from the associated process resource.
The process identifier or process handle is zero. (The process has not been started.)
You are attempting to access the PriorityBoostEnabled property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer.
The process Id is not available.
Remarks
The value returned by this property represents the most recently refreshed temporary priority boost. To get the most up to date value, you need to call Refresh() method first.
When a thread runs in a process for which the priority class has one of the dynamic priority enumeration values (Normal, High, or RealTime), the system temporarily boosts the thread's priority when it is taken out of a wait state. This action prevents other processes from interrupting the processing of the current thread. The PriorityBoostEnabled setting affects all the existing threads and any threads subsequently created by the process. To restore normal behavior, set the PriorityBoostEnabled property to false
.
Note
Boosting the priority too high can drain resources from essential operating system and network functions, causing problems with other operating system tasks.