Freigeben über


GetThreadPriority-Funktion (processthreadsapi.h)

Ruft den Prioritätswert für den angegebenen Thread ab. Dieser Wert bestimmt zusammen mit der Prioritätsklasse des Prozesses des Threads die Basisprioritätsebene des Threads.

Syntax

int GetThreadPriority(
  [in] HANDLE hThread
);

Parameter

[in] hThread

Ein Handle auf den Thread.

Das Handle muss über das THREAD_QUERY_INFORMATION - oder THREAD_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.

Windows Server 2003: Das Handle muss über das zugriffsrecht THREAD_QUERY_INFORMATION verfügen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Prioritätsebene des Threads.

Wenn die Funktion fehlschlägt, wird der Rückgabewert THREAD_PRIORITY_ERROR_RETURN. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Windows Phone 8.1: Diese Funktion gibt immer THREAD_PRIORITY_NORMAL zurück.

Die Prioritätsebene des Threads ist einer der folgenden Werte.

Rückgabecode/-wert BESCHREIBUNG
THREAD_PRIORITY_ABOVE_NORMAL
1
Priorität 1 Punkt über der Prioritätsklasse.
THREAD_PRIORITY_BELOW_NORMAL
-1
Priorität 1 Punkt unterhalb der Prioritätsklasse.
THREAD_PRIORITY_HIGHEST
2
Priorität 2 Punkte über der Prioritätsklasse.
THREAD_PRIORITY_IDLE
-15
Basispriorität 1 für IDLE_PRIORITY_CLASS, BELOW_NORMAL_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS, ABOVE_NORMAL_PRIORITY_CLASS oder HIGH_PRIORITY_CLASS Prozesse und eine Basispriorität von 16 für REALTIME_PRIORITY_CLASS Prozesse.
THREAD_PRIORITY_LOWEST
-2
Priorität 2 Punkte unterhalb der Prioritätsklasse.
THREAD_PRIORITY_NORMAL
0
Normale Priorität für die Prioritätsklasse.
THREAD_PRIORITY_TIME_CRITICAL
15
Basisprioritätsstufe 15 für IDLE_PRIORITY_CLASS, BELOW_NORMAL_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS, ABOVE_NORMAL_PRIORITY_CLASS oder HIGH_PRIORITY_CLASS Prozesse und die Basisprioritätsstufe 31 für REALTIME_PRIORITY_CLASS Prozesse.
 

Wenn der Thread über die REALTIME_PRIORITY_CLASS Basisklasse verfügt, kann diese Funktion auch einen der folgenden Werte zurückgeben: -7, -6, -5, -4, -3, 3, 4, 5 oder 6. Weitere Informationen finden Sie unter Planungsprioritäten.

Hinweise

Jeder Thread verfügt über eine Basisprioritätsebene, die durch den Prioritätswert des Threads und die Prioritätsklasse des Prozesses bestimmt wird. Das Betriebssystem verwendet die Basisprioritätsebene aller ausführbaren Threads, um zu bestimmen, welcher Thread den nächsten Slice der CPU-Zeit erhält. Threads werden auf jeder Prioritätsebene im Roundrobin-Modus geplant, und nur wenn keine ausführbaren Threads auf einer höheren Ebene vorhanden sind, erfolgt die Planung von Threads auf einer niedrigeren Ebene.

Eine Tabelle mit den Basisprioritätsebenen für jede Kombination aus Prioritätsklasse und Threadprioritätswert finden Sie in der SetPriorityClass-Funktion .

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps unterstützt.

Windows Phone 8.1:Windows Phone Store-Apps rufen diese Funktion möglicherweise auf, hat aber keine Auswirkung.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile processthreadsapi.h (einschließlich Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek Kernel32.lib; WindowsPhoneCore.lib unter Windows Phone 8.1
DLL Kernel32.dll; KernelBase.dll am Windows Phone 8.1

Weitere Informationen

GetPriorityClass

OpenThread

Prozess- und Threadfunktionen

Planungsprioritäten

SetPriorityClass

SetThreadPriority

Threads