ProcessThread.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 operating system should temporarily boost the priority of the associated thread whenever the main window of the thread's process receives 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
to boost the thread's priority when the user interacts with the process's interface; otherwise, false
. The default is false
.
Exceptions
The priority boost information could not be retrieved.
-or-
The priority boost information could not be set.
The process is on a remote computer.
Remarks
When PriorityBoostEnabled is true
, the system temporarily boosts the thread's priority whenever its associated process is taken out of the wait state. This action prevents other processes from interrupting the processing of the current thread. The PriorityBoostEnabled setting affects all existing threads as well as any threads subsequently created by the process. To restore normal behavior, set the PriorityBoostEnabled property to false
.
PriorityBoostEnabled has an effect only when the thread is running in a process that has a PriorityClass set to one of the dynamic priority enumeration values (Normal, High, or RealTime).
Note
Boosting the priority too high can drain resources from essential operating system and network functions. This could cause problems with other operating system tasks.