SetProcessPriorityBoost, fonction (processthreadsapi.h)

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

Voir aussi

GetProcessPriorityBoost

Priority Boosts

Fonctions de processus et de thread

Processus

Priorités de planification