KeSetBasePriorityThread-Funktion (ntddk.h)

  • Artikel

Die KeSetBasePriorityThread-Routine legt die Laufzeitpriorität relativ zum aktuellen Prozess für einen bestimmten Thread fest.

Syntax

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

Parameter

[in, out] Thread

Zeiger auf ein Dispatcherobjekt vom Typ KTHREAD.

[in] Increment

Gibt den Wert an, der der Basispriorität des Prozesses für den Thread hinzugefügt werden soll.

Rückgabewert

KeSetBasePriorityThread gibt den vorherigen Basisprioritätsschritt des angegebenen Threads zurück. Das vorherige Basisprioritätsinkrement wird als Unterschied zwischen der alten Basispriorität des angegebenen Threads und der Basispriorität des Prozesses des Threads definiert.

Hinweise

Die neue Basispriorität wird berechnet, indem der angegebene Inkrementwert, der ein negativer Wert sein kann, zur Basispriorität des angegebenen Threads-Prozesses hinzugefügt wird. Der resultierende Wert wird als Basispriorität des angegebenen Threads gespeichert.

Treiber, die gerätededizierte Threads mit Variablenprioritätsattributen einrichten, können diese Routine aufrufen, um die Priorität eines solchen Threads relativ zum Systemprozess festzulegen, in dem der Thread erstellt wird.

Die neue Basispriorität ist auf die Prioritätsklasse des Jeweiligen Threads-Prozesses beschränkt. Daher darf die Basispriorität nicht von einer Variablenprioritätsklasse zu einer Echtzeitprioritätsklasse wechseln oder umgekehrt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 2000.
Zielplattform Universell
Header ntddk.h (include Ntddk.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Weitere Informationen

KeGetCurrentThread

KeQueryPriorityThread

KeSetPriorityThread