FltIsOperationSynchronous 関数 (fltkernel.h)

[アーティクル]
08/07/2023

FltIsOperationSynchronous ルーチンは、特定のコールバックデータ構造 (FLT_CALLBACK_DATA) が同期または非同期の I/O 操作を表すかどうかを決定します。

構文

BOOLEAN FLTAPI FltIsOperationSynchronous(
  [in] PFLT_CALLBACK_DATA CallbackData
);

パラメーター

[in] CallbackData

操作のコールバックデータ構造へのポインター (FLT_CALLBACK_DATA)。

戻り値

FltIsOperationSynchronous は、操作が同期の場合は TRUE、操作が非同期の場合は FALSE を返します。

注釈

FltIsOperationSynchronous は、次の条件に従って、特定のコールバックデータ構造 (FLT_CALLBACK_DATA) が同期または非同期の I/O 操作を表すかどうかを決定します。

操作が IRP ベースの I/O 操作でない場合、操作は同期です。操作が IRP ベースであるかどうかを判断するには、 FLT_IS_IRP_OPERATION マクロを使用します。
操作が非同期ページング I/O 操作の場合、このリスト内の他の条件のいずれかが true の場合でも、操作は非同期です。
操作が同期ページング I/O 操作である場合、操作は同期です。
操作のファイルオブジェクトが同期 I/O 用に開かれた場合、操作は同期です。
操作の IRP でIRP_SYNCHRONOUS_API フラグが設定されている場合、操作は同期です。このフラグは、非同期 I/O 用に開かれたファイルオブジェクトに対して実行された場合でも、常に同期的なIRP_MJ_QUERY_INFORMATIONやIRP_MJ_SET_INFORMATIONなどの操作に設定されます。
上記の条件に該当しない場合、操作は非同期です。

注意

FltIsOperationSynchronous は、コールバックデータ構造が、非同期 I/O 用にファイルオブジェクトが開かれた場合でも、METHOD_BUFFEREDで定義された I/O 制御コード (IOCTL) またはファイルシステム制御コード (FSCTL) を使用してIRP_MJ_DEVICE_CONTROL、IRP_MJ_INTERNAL_DEVICE_CONTROL、またはIRP_MJ_FILE_SYSTEM_CONTROL操作を表す場合にも TRUE を返します。このような要求はファイルシステムによって同期的に行われる可能性がありますが、これは必ずしもすべての場合に当てはまるとは限りません。

FltIsOperationSynchronous が TRUE を返した場合、I/O 操作が同期されていることを示すわけではありません。つまり、TRUE 値は、ミニフィルタードライバーがこの操作の事前操作コールバック (PFLT_POST_OPERATION_CALLBACK) ルーチンでFLT_PREOP_SYNCHRONIZE返されたことを示していません。代わりに、 FltIsOperationSynchronous は TRUE を返して、I/O 操作が I/O マネージャーの観点から同期していることを示します。

FltIsOperationSynchronous は、高速 I/O、ファイルシステムフィルター (FSFilter) コールバック、IRP ベースの操作など、すべての操作クラスに対して呼び出すことができます。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	任意のレベル