FltSetIoPriorityHintIntoFileObject 関数 (fltkernel.h)

[アーティクル]
03/05/2024

FltSetIoPriorityHintIntoFileObject ルーチンは、ファイルオブジェクト内の I/O 優先度情報を設定するためにミニフィルタードライバーによって使用されます。

構文

NTSTATUS FLTAPI FltSetIoPriorityHintIntoFileObject(
  [in] PFILE_OBJECT     FileObject,
  [in] IO_PRIORITY_HINT PriorityHint
);

パラメーター

[in] FileObject

変更するファイルオブジェクトへのポインター。このパラメーターは必須であり、 NULL にすることはできません。

[in] PriorityHint

FileObject が指すファイルオブジェクトに対して設定するIO_PRIORITY_HINT列挙値。

戻り値

PriorityHint パラメーターで渡された I/O 優先度値が FileObject 構造体に正常に適用された場合、FltSetIoPriorityHintIntoFileObject はSTATUS_SUCCESSを返します。それ以外の場合は、次のいずれかの適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_INVALID_PARAMETER	PriorityHint パラメーターの値が無効です。これはエラーコードです。

注釈

このルーチンは NONPAGED であり、ページング I/O パスから呼び出すことができます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (FltKernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	<= DISPATCH_LEVEL