NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

Process.PriorityBoostEnabled

Gets or sets a value indicating whether the associated process priority should be temporarily boosted by the operating system when the main window has focus.

[Visual Basic]
Public Property PriorityBoostEnabled As Boolean
[C#]
public bool PriorityBoostEnabled {get; set;}
[C++]
public: __property bool get_PriorityBoostEnabled();
public: __property void set_PriorityBoostEnabled(bool);
[JScript]
public function get PriorityBoostEnabled() : Boolean;
public function set PriorityBoostEnabled(Boolean);

Property Value

true if dynamic boosting of the process priority should take place for a process when it is taken out of wait state; otherwise, false. The default is false.

Exceptions

Exception Type Condition
Win32Exception Priority boost information could not be retrieved from the associated process resource.

-or-

The process ID or process handle is 0. (The process has not been started.)

SystemException You are attempting to access the Modules on a remote computer. The property is only available for processes running on the local computer.

-or-

The process Id is not available.

Remarks

When a thread runs in a process whose priority class has one of the dynamic priority enumeration values (Normal, High, or RunTime), the system temporarily boosts the thread's priority when it is taken out of a wait state. This prevents other processes from interrupting the processing of the current thread. The PriorityBoostEnabled setting affects all 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.

See Also

Process Class | Process Members | System.Diagnostics Namespace | PriorityClass | BasePriority