Difference between revisions of "SetPriorityClass"

From Lazarus wiki
Jump to navigationJump to search
m (Text replace - "delphi>" to "syntaxhighlight>")
m (Fixed syntax highlighting)
 
Line 1: Line 1:
 +
{{set priority class}}
 +
 
SetPriorityClass - a function that sets the priority class for a specified process.  This function is specific to Windows.
 
SetPriorityClass - a function that sets the priority class for a specified process.  This function is specific to Windows.
 
  
 
The SetPriorityClass may have one of the following priority classes:
 
The SetPriorityClass may have one of the following priority classes:
Line 7: Line 8:
 
* IDLE_PRIORITY_CLASS <= Idle performs tasks when the system is idle.<br>
 
* IDLE_PRIORITY_CLASS <= Idle performs tasks when the system is idle.<br>
 
* NORMAL_PRIORITY_CLASS <= Normal performs tasks at regular speed.<br>
 
* NORMAL_PRIORITY_CLASS <= Normal performs tasks at regular speed.<br>
* REALTIME_PRIORITY_CLASS <= Real Time performs tasks immediately and above all other tasks, including operating system tasks.<br>
+
* REALTIME_PRIORITY_CLASS <= Real Time performs tasks immediately and above all other tasks, including operating system tasks.
  
 
Use caution when using REALTIME_PRIORITY_CLASS.  It can potentially take so
 
Use caution when using REALTIME_PRIORITY_CLASS.  It can potentially take so
 
much of the CPU resources that there may not be anything left for other items
 
much of the CPU resources that there may not be anything left for other items
 
to run, including operating system requests.
 
to run, including operating system requests.
 
  
 
EXAMPLE:
 
EXAMPLE:
  
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
uses Windows; // Unit containing the SetPriorityClass function.
 
uses Windows; // Unit containing the SetPriorityClass function.
  

Latest revision as of 12:40, 26 February 2020

Windows logo - 2012.svg

This article applies to Windows only.

See also: Multiplatform Programming Guide

English (en)

SetPriorityClass - a function that sets the priority class for a specified process. This function is specific to Windows.

The SetPriorityClass may have one of the following priority classes:

  • HIGH_PRIORITY_CLASS <= High performs tasks immediately.
  • IDLE_PRIORITY_CLASS <= Idle performs tasks when the system is idle.
  • NORMAL_PRIORITY_CLASS <= Normal performs tasks at regular speed.
  • REALTIME_PRIORITY_CLASS <= Real Time performs tasks immediately and above all other tasks, including operating system tasks.

Use caution when using REALTIME_PRIORITY_CLASS. It can potentially take so much of the CPU resources that there may not be anything left for other items to run, including operating system requests.

EXAMPLE:

uses Windows; // Unit containing the SetPriorityClass function.

procedure TForm1.FormCreate(Sender: TObject);
begin
     SetPriorityClass(GetCurrentProcess(), HIGH_PRIORITY_CLASS);
     // Sets the current running application to High Priority.
end;