SetThreadPriorityBoost-Funktion (processthreadsapi.h)
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 |