SetProcessPriorityBoost-Funktion (processthreadsapi.h)

  • Artikel

Deaktiviert oder aktiviert die Möglichkeit des Systems, die Priorität der Threads des angegebenen Prozesses vorübergehend zu erhöhen.

Syntax

BOOL SetProcessPriorityBoost(
  [in] HANDLE hProcess,
  [in] BOOL   bDisablePriorityBoost
);

Parameter

[in] hProcess

Ein Handle für den Prozess. Dieses Handle muss über das PROCESS_SET_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

[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 SetProcessPriorityBoost aufgerufen wird und der DisablePriorityBoost-Parameter auf TRUE festgelegt ist, werden die Prioritäten der Threads nicht erhöht. Diese Einstellung wirkt sich auf alle vorhandenen Threads und alle anschließend vom Prozess erstellten Threads aus. Um das normale Verhalten wiederherzustellen, rufen Sie SetProcessPriorityBoost 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 (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

GetProcessPriorityBoost

Prioritätsschub

Prozess- und Threadfunktionen

Prozesse

Planungsprioritäten