SetThreadPriorityBoost, fonction (processthreadsapi.h)

Désactive ou active la capacité du système à augmenter temporairement la priorité d’un thread.

Syntaxe

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

Paramètres

[in] hThread

Handle pour le thread dont la priorité est d’être renforcée. Le handle doit avoir le droit d’accès THREAD_SET_INFORMATION ou THREAD_SET_LIMITED_INFORMATION . Pour plus d’informations, consultez Sécurité des threads et droits d’accès.

Windows Server 2003 et Windows XP : Le handle doit avoir le droit d’accès THREAD_SET_INFORMATION .

[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 SetThreadPriorityBoost est appelé avec le paramètre DisablePriorityBoost défini sur TRUE, la priorité du thread n’est pas renforcée. Pour restaurer un comportement normal, appelez SetThreadPriorityBoost avec DisablePriorityBoost défini sur FALSE.

Configuration requise

Voir aussi

GetThreadPriorityBoost

OpenThread

Priority Boosts

Fonctions de processus et de thread

Priorités de planification

Threads