KeSetBasePriorityThread, fonction (ntddk.h)

La routine KeSetBasePriorityThread définit la priorité d’exécution, par rapport au processus actuel, pour un thread donné.

Syntaxe

LONG KeSetBasePriorityThread(
  [in, out] PKTHREAD Thread,
  [in]      LONG     Increment
);

Paramètres

[in, out] Thread

Pointeur vers un objet de répartiteur de type KTHREAD.

[in] Increment

Spécifie la valeur à ajouter à la priorité de base du processus pour le thread.

Valeur retournée

KeSetBasePriorityThread retourne l’incrément de priorité de base précédent du thread donné. L’incrément de priorité de base précédent est défini comme la différence entre l’ancienne priorité de base du thread spécifié et la priorité de base du processus du thread.

Remarques

La nouvelle priorité de base est calculée en ajoutant l’incrément donné, qui peut être une valeur négative, à la priorité de base du processus du thread spécifié. La valeur résultante est stockée en tant que priorité de base du thread spécifié.

Les pilotes qui configurent des threads dédiés à l’appareil avec des attributs de priorité variable peuvent appeler cette routine pour définir la priorité d’un thread par rapport au processus système dans lequel le thread est créé.

La nouvelle priorité de base est limitée à la classe de priorité du processus du thread donné. Par conséquent, la priorité de base n’est pas autorisée à passer d’une classe de priorité variable à une classe de priorité en temps réel ou vice versa.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	ntddk.h (incluez Ntddk.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Voir aussi

KeGetCurrentThread

KeQueryPriorityThread

KeSetPriorityThread