Export (0) Print
Expand All

Process.PriorityBoostEnabled Property

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.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

public bool PriorityBoostEnabled { get; set; }
/** @property */
public boolean get_PriorityBoostEnabled ()

/** @property */
public void set_PriorityBoostEnabled (boolean value)

public function get PriorityBoostEnabled () : boolean

public function set PriorityBoostEnabled (value : boolean)

Not applicable.

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.

Exception typeCondition

Win32Exception

Priority boost information could not be retrieved from the associated process resource.

PlatformNotSupportedException

The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property.

-or-

The process identifier or process handle is zero. (The process has not been started.)

NotSupportedException

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.

InvalidOperationException

The process Id is not available.

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.

NoteNote:

Boosting the priority too high can drain resources from essential operating system and network functions, causing problems with other operating system tasks.

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

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft