Fonction NtSetInformationThread (ntifs.h)

  • Article

La routine NtSetInformationThread définit la priorité d’un thread.

Syntaxe

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetInformationThread(
  [in] HANDLE          ThreadHandle,
  [in] THREADINFOCLASS ThreadInformationClass,
  [in] PVOID           ThreadInformation,
  [in] ULONG           ThreadInformationLength
);

Paramètres

[in] ThreadHandle

Handle vers l’objet thread. Pour créer un thread et obtenir un handle, appelez PsCreateSystemThread. Pour spécifier le thread actuel, utilisez la macro ZwCurrentThread .

[in] ThreadInformationClass

Une des valeurs définies par le système dans l’énumération THREADINFOCLASS (voir ntddk.h), ThreadPriority, ThreadBasePriority, ThreadPagePriority ou ThreadPowerThrottlingState.

[in] ThreadInformation

Pointeur vers une variable qui spécifie les informations à définir.

Si ThreadInformationClass est ThreadPriority, cette valeur doit être > LOW_PRIORITY et <= HIGH_PRIORITY.

Si ThreadInformationClass est ThreadBasePriority, cette valeur doit être comprise dans la plage de priorité de base valide du système et la classe de priorité d’origine pour le thread donné. Autrement dit, si la classe de priorité d’un thread est variable, la priorité de base de ce thread ne peut pas être réinitialisée à une valeur de priorité en temps réel, et vice versa.

Si ThreadInformationClass est ThreadPagePriority, cette valeur est un pointeur vers une structure PAGE_PRIORITY_INFORMATION , consultez ntddk.h. La valeur du membre PagePriority doit être l’une de ces valeurs.

Si ThreadInformationClass est ThreadPowerThrottlingState, cette valeur est un pointeur vers une structure POWER_THROTTLING_THREAD_STATE , consultez ntddk.h. La valeur du membre PagePriority doit être l’une de ces valeurs.

Valeur Signification
MEMORY_PRIORITY_VERY_LOW (1) Priorité mémoire très faible.
MEMORY_PRIORITY_LOW (2) Faible priorité de mémoire.
MEMORY_PRIORITY_MEDIUM (3) Priorité de mémoire moyenne.
MEMORY_PRIORITY_BELOW_NORMAL (4) En dessous de la priorité de mémoire normale.
MEMORY_PRIORITY_NORMAL (5) Priorité de mémoire normale. Il s’agit de la priorité par défaut pour tous les threads et processus sur le système.

[in] ThreadInformationLength

Taille, en octets, de ThreadInformation.

Valeur retournée

NtSetInformationThread retourne STATUS_SUCCESS en cas de réussite ou le code d’erreur NTSTATUS approprié en cas d’échec. Les codes d’erreur possibles incluent STATUS_INFO_LENGTH_MISMATCH ou STATUS_INVALID_PARAMETER.

Remarques

NtSetInformationThread peut être appelé par des pilotes de niveau supérieur pour définir la priorité d’un thread pour lequel ils ont un handle.

L’appelant doit disposer de droits d’accès THREAD_SET_INFORMATION pour le thread donné afin d’appeler cette routine.

En règle générale, les pilotes de périphérique et intermédiaires qui configurent des threads créés par un pilote appellent KeSetBasePriorityThread ou KeSetPriorityThread à partir de leurs threads créés par le pilote, au lieu d’appeler NtSetInformationThread. Toutefois, un pilote peut appeler NtSetInformationThread pour augmenter la priorité d’un thread créé par le pilote avant l’exécution de ce thread.

Les pilotes en mode noyau peuvent appeler la fonction NtSetInformationThread avec ThreadPagePriority pour spécifier la priorité de page d’un thread.

Pour améliorer les performances du système, les pilotes doivent utiliser la fonction avec ThreadPagePriority pour réduire la priorité des pages des threads qui effectuent des opérations en arrière-plan ou accèdent aux fichiers et aux données qui ne devraient pas être consultés prochainement. Par exemple, une application anti-programme malveillant peut réduire la priorité des threads impliqués dans l’analyse des fichiers.

Notes

Si l’appel à cette fonction se produit en mode noyau, vous devez utiliser le nom ZwSetInformationThread au lieu de NtSetInformationThread.

Pour les appels provenant de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Using Nt and Zw Versions of the Native System Services Routines..

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000
Plateforme cible Universal
En-tête ntifs.h (inclure Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs, PowerIrpDDis

Voir aussi

KeSetBasePriorityThread

KeSetPriorityThread

PsCreateSystemThread

Utilisation des versions Nt et Zw des routines des services système natifs.