SetThreadPriorityBoost-Funktion (processthreadsapi.h)

Artikel
03/01/2024

Deaktiviert oder aktiviert die Fähigkeit des Systems, die Priorität eines Threads vorübergehend zu erhöhen.

Syntax

BOOL SetThreadPriorityBoost(
  [in] HANDLE hThread,
  [in] BOOL   bDisablePriorityBoost
);

Parameter

[in] hThread

Ein Handle für den Thread, dessen Priorität erhöht werden soll. Das Handle muss über das zugriffsrecht THREAD_SET_INFORMATION oder THREAD_SET_LIMITED_INFORMATION verfügen. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.

Windows Server 2003 und Windows XP: Das Handle muss über das Zugriffsrecht THREAD_SET_INFORMATION verfügen.

[in] bDisablePriorityBoost

Wenn dieser Parameter TRUE ist, ist die dynamische Verstärkung deaktiviert. Wenn der Parameter FALSE ist, ist die dynamische Verstärkung aktiviert.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn ein Thread in einer der dynamischen Prioritätsklassen ausgeführt wird, erhöht das System vorübergehend die Priorität des Threads, wenn er aus einem Wartezustand entfernt wird. Wenn SetThreadPriorityBoost aufgerufen wird, wobei der Parameter DisablePriorityBoost auf TRUE festgelegt ist, wird die Priorität des Threads nicht erhöht. Um das normale Verhalten wiederherzustellen, rufen Sie SetThreadPriorityBoost auf, wobei DisablePriorityBoost auf FALSE festgelegt ist.

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 (enthalten Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll