KeSetBasePriorityThread 関数 (ntddk.h)

KeSetBasePriorityThread ルーチンは、特定のスレッドの現在のプロセスを基準にして、実行時の優先度を設定します。

構文

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

[in, out] Thread

KTHREAD 型のディスパッチャーオブジェクトへのポインター。

[in] Increment

スレッドのプロセスの基本優先度に追加する値を指定します。

KeSetBasePriorityThread は、指定されたスレッドの前の基本優先度の増分を返します。前の基本優先度の増分は、指定されたスレッドの古い基本優先度とスレッドのプロセスの基本優先度の差として定義されます。

新しい基本優先度は、指定した インクリメント(負の値) を指定したスレッドのプロセスの基本優先度に追加することによって計算されます。結果の値は、指定されたスレッドの基本優先度として格納されます。

可変優先度属性を持つデバイス専用スレッドを設定するドライバーは、このルーチンを呼び出して、スレッドが作成されるシステムプロセスを基準にして、このようなスレッドの優先度を設定できます。

新しい基本優先度は、指定されたスレッドのプロセスの優先順位クラスに制限されます。したがって、基本優先度は、変数優先度クラスからリアルタイム優先度クラスに、またはその逆に渡ることはできません。