FLT_IO_PARAMETER_BLOCK構造体 (fltkernel.h)

[アーティクル]
02/06/2025

FLT_IO_PARAMETER_BLOCK 構造体には、FLT_CALLBACK_DATA コールバックデータ構造によって表される I/O 操作のパラメーターが含まれています。

構文

typedef struct _FLT_IO_PARAMETER_BLOCK {
  ULONG          IrpFlags;
  UCHAR          MajorFunction;
  UCHAR          MinorFunction;
  UCHAR          OperationFlags;
  UCHAR          Reserved;
  PFILE_OBJECT   TargetFileObject;
  PFLT_INSTANCE  TargetInstance;
  FLT_PARAMETERS Parameters;
} FLT_IO_PARAMETER_BLOCK, *PFLT_IO_PARAMETER_BLOCK;

メンバーズ

IrpFlags

I/O 操作のさまざまな側面を指定するフラグのビットマスク。これらのフラグは、IRP ベースの操作にのみ使用されます。フラグ値を次の表に示します。

価値	意味
IRP_BUFFERED_IO	この操作は、バッファー内の I/O 操作です。
IRP_CLOSE_OPERATION	操作はクリーンアップ操作または終了操作です。
IRP_DEALLOCATE_BUFFER	I/O マネージャーは、IRP の完了フェーズ中にバッファーを解放します。
IRP_INPUT_OPERATION	操作は入力操作です。
IRP_NOCACHE	この操作は、キャッシュされていない I/O 操作です。
IRP_PAGING_IO	操作はページング I/O 操作です。
IRP_SYNCHRONOUS_API	I/O 操作は同期です。
IRP_SYNCHRONOUS_PAGING_IO	操作は同期ページング I/O 操作です。
IRP_MOUNT_COMPLETION	操作のボリュームマウントが完了しました。
IRP_CREATE_OPERATION	操作は、作成操作または開いている操作です。
IRP_READ_OPERATION	I/O 操作は読み取り用です。
IRP_WRITE_OPERATION	I/O 操作は書き込み用です。
IRP_DEFER_IO_COMPLETION	操作の I/O 完了は遅延されます。
IRP_ASSOCIATED_IRP	操作はマスター IRP に関連付けられています。
IRP_OB_QUERY_NAME	操作は非同期の名前クエリです。
IRP_HOLD_DEVICE_QUEUE	引っ込み思案。
IRP_UM_DRIVER_INITIATED_IO	操作は、ユーザーモードドライバーから発生しました。

MajorFunction

I/O 操作の主要な関数コード。主要な関数コードは、IRP ベースの操作、高速 I/O 操作、およびファイルシステム (FSFilter) コールバック操作に使用されます。その他の操作の詳細については、FLT_PARAMETERSを参照してください。

MinorFunction

I/O 操作のマイナー関数コード。このメンバーは省略可能であり、NULL できます。 MajorFunction メンバー 値によって、使用可能な値が決まります。マイナー関数コードの詳細については、FLT_PARAMETERSを参照してください。

OperationFlags

I/O 操作のさまざまな側面を指定するフラグのビットマスク。これらのフラグは、IRP ベースの操作にのみ使用されます。フィルターマネージャーは、IRPに関連付けられている IO_STACK_LOCATION 構造体の フラグ メンバーからこれらのフラグをコピーします。次の表は、最もよく使用されるフラグ値を示しています。

価値	意味
SL_CASE_SENSITIVE	IRP_MJ_CREATEに使用されます。このフラグが設定されている場合、ファイル名の比較では大文字と小文字が区別されます。
SL_EXCLUSIVE_LOCK	IRP_MJ_LOCK_CONTROLに使用されます。このフラグが設定されている場合は、排他的バイト範囲ロックが要求されます。それ以外の場合は、共有ロックが要求されます。
SL_FAIL_IMMEDIATELY	IRP_MJ_LOCK_CONTROLに使用されます。このフラグが設定されている場合、すぐに許可できない場合、ロック要求は失敗します。
SL_FORCE_ACCESS_CHECK	IRP_MJ_CREATEに使用されます。このフラグが設定されている場合は、IRP の RequestorMode メンバーの値が KernelMode 場合でも、アクセスチェックを実行する必要があります。
SL_FORCE_DIRECT_WRITE	IRP_MJ_WRITEとIOCTL_DISK_COPY_DATAに使用されます。このフラグが設定されている場合、カーネルモードドライバーは、通常、セキュリティ上の理由から書き込みがブロックされているボリューム領域に書き込むことができます。このフラグは、ファイルシステムレイヤーとストレージスタックレイヤーの両方でオンになります。 SL_FORCE_DIRECT_WRITE フラグは、Windows Vista 以降のバージョンの Windows で使用できます。
SL_INDEX_SPECIFIED	IRP_MJ_DIRECTORY_CONTROL、IRP_MJ_QUERY_EA、および IRP_MJ_SET_QUOTAに使用されます。このフラグが設定されている場合、ディレクトリ、クォータ、または拡張属性の情報のスキャンは、インデックスが指定されているリスト内のエントリから開始する必要があります。
SL_OPEN_PAGING_FILE	IRP_MJ_CREATEに使用されます。このフラグが設定されている場合、ファイルはページングファイルです。
SL_OPEN_TARGET_DIRECTORY	IRP_MJ_CREATEに使用されます。このフラグが設定されている場合は、ファイルの親ディレクトリを開く必要があります。
SL_OVERRIDE_VERIFY_VOLUME	IRP_MJ_DIRECTORY_CONTROL、IRP_MJ_READ、および IRP_MJ_WRITEに使用されます。このフラグが設定されている場合、ボリュームのデバイスオブジェクトに DO_VERIFY_VOLUME フラグが設定されている場合でも、I/O 操作を実行する必要があります。
SL_RESTART_SCAN	IRP_MJ_DIRECTORY_CONTROL、IRP_MJ_QUERY_EA、および IRP_MJ_SET_QUOTAに使用されます。このフラグが設定されている場合、ディレクトリ、クォータ、または拡張属性の情報のスキャンは、ディレクトリまたはリストの最初のエントリから開始する必要があります。それ以外の場合は、前のスキャンからスキャンを再開する必要があります。
SL_RETURN_SINGLE_ENTRY	IRP_MJ_DIRECTORY_CONTROL、IRP_MJ_QUERY_EA、および IRP_MJ_SET_QUOTAに使用されます。このフラグが設定されている場合、ディレクトリ、クォータ、または拡張属性の情報をスキャンすると、最初に見つかったエントリのみが返されます。
SL_WATCH_TREE	IRP_MJ_DIRECTORY_CONTROLに使用されます。このフラグが設定されている場合は、このディレクトリのすべてのサブディレクトリも監視する必要があります。それ以外の場合は、ディレクトリ自体のみが監視されます。
SL_WRITE_THROUGH	IRP_MJ_WRITEに使用されます。このフラグが設定されている場合、ファイルデータはキャッシュに書き込まれるだけでなく、永続ストレージに書き込まれる必要があります。

Reserved

システム用に予約されています。使用しないでください。

TargetFileObject

この I/O 操作のターゲットであるファイルまたはディレクトリのファイルオブジェクトポインター。

TargetInstance

この I/O 操作のターゲットであるミニフィルターの不透明なインスタンスポインター。

Parameters

MajorFunction および MinorFunction メンバーで指定された I/O 操作のパラメーター 含む FLT_PARAMETERS 構造体。

備考

FLT_IO_PARAMETER_BLOCK 構造体には、コールバックデータ (FLT_CALLBACK_DATA) 構造体で表される I/O 操作のパラメーターが含まれています。コールバックデータ構造体には、Iopb メンバー内のFLT_IO_PARAMETER_BLOCK構造体へのポインターが含まれています。

ミニフィルターは、コールバックデータ構造体へのポインターを、データ として受け取るか、次のコールバックルーチン型への入力パラメーター CallbackData 受け取ります。

ミニフィルターの事前操作コールバックルーチンと事後操作コールバックルーチンは、MajorFunction および予約済み メンバーを除き、I/O 操作のFLT_IO_PARAMETER_BLOCK構造体 内容を変更できます。その場合は、操作のコールバックデータ構造の IoStatus メンバーも変更していない限り、FltSetCallbackDataDirty呼び出す必要があります。それ以外の場合、変更された値は無視されます。

フィルターマネージャーがミニフィルターに対して事前操作コールバックまたは事後処理コールバックを発行した場合、FltObjects- >FileObject と TargetFileObject (CallbackData->Iopb->TargetFileObject) は、最初は同じです。ミニフィルターが TargetFileObject 変更するか、TargetInstance をした場合、後続の呼び出しでプリオペレーションコールバックから FltSetCallbackDataDirty をすると、フィルターマネージャーは、操作を下位フィルターに送信する前に、FltObjects->FileObject と fltObjects->インスタンス 置き換えます。

ミニフィルターの事前操作コールバックルーチンが I/O 操作のパラメーターを変更した場合、ミニフィルターインスタンススタック内のミニフィルターの下にあるすべてのミニフィルターは、その前操作および事後操作コールバックルーチンで変更されたパラメーターを受け取ります。

変更されたパラメーターは、ミニフィルターの独自のポスト操作コールバックルーチン、またはミニフィルターインスタンススタック内のミニフィルターの上のミニフィルターでは受け取りません。いずれの場合も、ミニフィルターの事前操作コールバックルーチンと事後操作コールバックルーチンは、同じ入力パラメーター値を受け取ります。

ミニフィルターが TargetInstance メンバーの値を変更する場合、新しい値は、異なるボリューム上の同じ高度にある同じミニフィルターのインスタンスへのポインターである必要があります。さらに、新しいボリュームのデバイスオブジェクトには、元のボリュームのデバイスオブジェクト以上のスタックサイズが必要です。

ボリュームにアタッチされているインスタンスの不透明なインスタンスポインターを指定して、ボリュームデバイスオブジェクトのスタックサイズを取得するには、次の操作を行います。

FltGetVolumeFromInstance 呼び出して、ボリュームポインターを取得します。
FltGetDeviceObject 呼び出して、ボリュームデバイスオブジェクトへのポインターを取得します。このポインターは、DeviceObject パラメーターで返されます。デバイスオブジェクトのスタックサイズは、DeviceObject->StackSize にあります。
ボリュームポインターが不要になったら、FltObjectDereference 呼び出して参照カウントを減らします。
ボリュームデバイスオブジェクトポインターが不要になったら、ObDereferenceObject を呼び出して、その参照カウントを減らします。

ミニフィルターは、TargetFileObject メンバーの値を変更できます。ただし、新しい値は、TargetInstance メンバーによって指定されたインスタンスと同じボリューム上にあるファイルのファイルオブジェクトへのポインターである必要があります。

ミニフィルターは、MajorFunction メンバーの値を安全に変更できません。代わりに、新しい I/O 操作を開始する必要があります。

ミニフィルターは、FltReadFileなどのサポートルーチンを呼び出すか、fltAllocateCallbackData呼び出してコールバックデータ構造を割り当てることによって、I/O 操作を開始できます。FLT_IO_PARAMETER_BLOCK 構造体の I/O パラメーターを初期化し、コールバックデータ構造を FltPerformSynchronousIoまたは fltPerformAsynchronousIo渡します。

手記

I/O 操作を開始するときは、可能な限りサポートルーチンを使用します。ミニフィルターは、特定の I/O 操作のサポート関数がない場合にのみ、独自のコールバックデータを割り当てる必要があります。

必要条件

要件	価値
ヘッダー	fltkernel.h (Fltkernel.h を含む)

次の方法で共有

FLT_IO_PARAMETER_BLOCK構造体 (fltkernel.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース