FltApplyPriorityInfoThread 関数 (fltkernel.h)

[アーティクル]
02/26/2024

FltApplyPriorityInfoThread ルーチンは、スレッドに優先順位情報を適用するためにミニフィルタードライバーによって使用されます。

構文

NTSTATUS FLTAPI FltApplyPriorityInfoThread(
  [in]            PIO_PRIORITY_INFO InputPriorityInfo,
  [out, optional] PIO_PRIORITY_INFO OutputPriorityInfo,
  [in]            PETHREAD          Thread
);

パラメーター

[in] InputPriorityInfo

指定したスレッドの優先度の状態を設定するために使用されるIO_PRIORITY_INFO構造体へのポインター。このIO_PRIORITY_INFO構造体のメンバーは、適切なルーチンによって設定されている必要があります。次の「解説」セクションを参照してください。このパラメーターは必須であり、 NULL にすることはできません。

[out, optional] OutputPriorityInfo

InputPriorityInfo 優先度情報が FltApplyPriorityInfoThread によってスレッドに適用される前に、スレッドの優先度状態を受け取るために使用される、IO_PRIORITY_INFO構造体への省略可能なポインター。このパラメーターは省略可能であり、 NULL にすることができます。

[in] Thread

InputPriorityInfo 優先度情報を適用するスレッドへのポインター。このパラメーターは必須であり、 NULL にすることはできません。

戻り値

InputPriorityInfo パラメーターが指すスレッド優先度情報が指定されたスレッドに正常に適用された場合、FltApplyPriorityInfoThread ルーチンはSTATUS_SUCCESSを返します。それ以外の場合は、次のいずれかの適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_INVALID_PARAMETER_1	InputPriorityInfo パラメーターが指す構造体は初期化されましたが、そのメンバー値の 1 つ以上が無効です。これはエラーコードです。

注釈

このルーチンは、Windows Vista 以降で使用できます。

FltApplyPriorityInfoThread ルーチンは、InputPriorityInfo パラメーターが指すIO_PRIORITY_INFO構造体のメンバー値に基づいて、指定されたスレッドの I/O 優先度、ページング優先度、およびスレッド優先度を設定します。これにより、 FltRetrieveIoPriorityInfo または FltApplyPriorityInfoThread ルーチンによって取得された、以前に保存した優先度情報のセットをスレッドに適用できます。

有効な OutputPriorityInfo ポインターが指定されている場合、InputPriorityInfo 優先度値が FltApplyPriorityInfoThread ルーチンによって適用される前のターゲットスレッドの元の値を保存できます。 OutputPriorityInfo パラメーターが指す構造体を初期化する必要はありません。

InputPriorityInfo パラメーターと OutputPriorityInfo パラメーターの両方に対して、単一のIO_PRIORITY_INFO構造体への同じポインターを指定しても安全です。

メモInputPriorityInfo パラメーターが指すIO_PRIORITY_INFO構造体のメンバー値が設定されていない場合は、次のいずれかのメソッドを使用して FltApplyPriorityInfoThread ルーチンを呼び出す前に、これらのメンバーを設定する必要があります。

FltRetrieveIoPriorityInfo ルーチンを呼び出します。
FltApplyPriorityInfoThread ルーチンの前の呼び出しで、現在の InputPriorityInfo パラメーターが OutputPriorityInfo パラメーターであることを確認します。

要件

要件	値
サポートされている最小のクライアント	Microsoft Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	Fltmgr.lib
IRQL	<= DISPATCH_LEVEL