# Function Reference

# _ProcessGetPriority

Get the priority of an open process

#include <Process.au3>
_ProcessGetPriority ( $vProcess )

## Parameters

$vProcess | The name or PID of the process to be examined.

## Return Value

Success: | an integer corressponding to the processes's priority: 0 - Idle/Low 1 - Below Normal 2 - Normal 3 - Above Normal 4 - High 5 - Realtime
Failure: | -1 and sets the @error flag to non-zero.

## Example

    #include <MsgBoxConstants.au3>
    #include <Process.au3>

    Local $i_Priority_Level, $i_Notepad_PID, $i_ArrayItem
    Local $a_RunLevels[3] = [0, 2, 4] ;low, normal, high priorities
    ; Get Priority Level of this instance of AutoIt Scripting Engine
    $i_Priority_Level = _ProcessGetPriority(@AutoItPID)
    MsgBox($MB_SYSTEMMODAL, "AutoIt Script", "Should be 2: " & $i_Priority_Level)
    $i_Notepad_PID = Run(@ComSpec & ' /k notepad.exe', '', @SW_HIDE)
    For $i_ArrayItem = 0 To 2
        ProcessSetPriority($i_Notepad_PID, $a_RunLevels[$i_ArrayItem])
        $i_Priority_Level = _ProcessGetPriority($i_Notepad_PID)
        MsgBox($MB_SYSTEMMODAL, "Notepad Priority", "Should be " & $a_RunLevels[$i_ArrayItem] & ": " & $i_Priority_Level)
    Next
    ProcessClose('notepad.exe')