SetProcessPriorityBoost, fonction (processthreadsapi.h)

Article
03/01/2024

Désactive ou active la capacité du système à augmenter temporairement la priorité des threads du processus spécifié.

Syntaxe

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

Paramètres

[in] hProcess

Handle du processus. Ce handle doit avoir le droit d’accès PROCESS_SET_INFORMATION. Pour plus d’informations, consultez Droits d’accès et de sécurité des processus.

[in] bDisablePriorityBoost

Si ce paramètre a la valeur TRUE, la stimulation dynamique est désactivée. Si le paramètre a la valeur FALSE, la stimulation dynamique est activée.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Lorsqu’un thread s’exécute dans l’une des classes de priorité dynamique, le système augmente temporairement la priorité du thread lorsqu’il est sorti de l’état d’attente. Si SetProcessPriorityBoost est appelé avec le paramètre DisablePriorityBoost défini sur TRUE, les priorités de ses threads ne sont pas renforcées. Ce paramètre affecte tous les threads existants et tous les threads créés par la suite par le processus. Pour restaurer un comportement normal, appelez SetProcessPriorityBoost avec DisablePriorityBoost défini sur FALSE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	processthreadsapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll