GetThreadPriority-Funktion (processthreadsapi.h)

Artikel
08/25/2023

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