Process.PriorityBoostEnabled Property

Definition

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.

Applies to

See also