Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Specifies the priority level for the task.
<xs:element name="Priority"
type="priorityType"
default="7"
minOccurs="0"
/>
The Priority element is defined by the settingsType complex type.
Parent element
Element | Derived from | Description |
---|---|---|
Settings | settingsType | Contains the settings that the Task Scheduler uses to perform the task. |
Remarks
Priority level 0 is the highest priority, and priority level 10 is the lowest priority. The default value is 7. The minimum and maximum values are set by the priorityType simple type. Priority levels 7 and 8 are used for background tasks, and priority levels 4, 5, and 6 are used for interactive tasks.
The task's action is started in a process with a priority that is based on a Priority Class value. A Priority Level value (thread priority) is used for COM handler, message box, and email task actions. For more information about the Priority Class and Priority Level values, see Scheduling Priorities; for more information about I/O Priority values, see IO_PRIORITY_HINT enumeration; for information about Memory Priority values, see MEMORY_PRIORITY_INFORMATION structure. The following table lists the possible values for the Priority element, and the corresponding Priority Class, Priority Level, I/O Priority and Memory Priority values.
Task Priority | Priority Class | Priority Level | I/O Priority | Memory Priority |
---|---|---|---|---|
0 | REALTIME_PRIORITY_CLASS | THREAD_PRIORITY_TIME_CRITICAL | IoPriorityNormal | MEMORY_PRIORITY_NORMAL |
1 | HIGH_PRIORITY_CLASS | THREAD_PRIORITY_HIGHEST | IoPriorityNormal | MEMORY_PRIORITY_NORMAL |
2 | ABOVE_NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_ABOVE_NORMAL | IoPriorityNormal | MEMORY_PRIORITY_NORMAL |
3 | ABOVE_NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_ABOVE_NORMAL | IoPriorityNormal | MEMORY_PRIORITY_NORMAL |
4 | NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_NORMAL | IoPriorityNormal | MEMORY_PRIORITY_NORMAL |
5 | NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_NORMAL | IoPriorityNormal | MEMORY_PRIORITY_BELOW_NORMAL |
6 | NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_NORMAL | IoPriorityNormal | MEMORY_PRIORITY_MEDIUM |
7 | BELOW_NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_BELOW_NORMAL | IoPriorityLow | MEMORY_PRIORITY_LOW |
8 | BELOW_NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_BELOW_NORMAL | IoPriorityLow | MEMORY_PRIORITY_VERY_LOW |
9 | IDLE_PRIORITY_CLASS | THREAD_PRIORITY_LOWEST | IoPriorityVeryLow | MEMORY_PRIORITY_VERY_LOW |
10 | IDLE_PRIORITY_CLASS | THREAD_PRIORITY_IDLE | IoPriorityVeryLow | MEMORY_PRIORITY_VERY_LOW |
For C++ development, see Priority Property of ITaskSettings.
For script development, see TaskSettings.Priority.
Requirements
Requirement | Value |
---|---|
Minimum supported client |
Windows Vista [desktop apps only] |
Minimum supported server |
Windows Server 2008 [desktop apps only] |