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

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.

Security

LinkDemand
for full trust for the immediate caller. This member cannot be used by partially trusted code.

Applies to

See also