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
| 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 sur Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |