FltReissueSynchronousIo 関数 (fltkernel.h)

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

FltReissueSynchronousIo は 、以前に同期された I/O 操作のパラメーターを使用する新しい同期 I/O 操作を開始します。

構文

VOID FLTAPI FltReissueSynchronousIo(
  [in] PFLT_INSTANCE      InitiatingInstance,
  [in] PFLT_CALLBACK_DATA CallbackData
);

パラメーター

[in] InitiatingInstance

I/O 操作を再開するミニフィルタードライバーインスタンスへの不透明なインスタンスポインター。前の I/O 操作を開始したのと同じインスタンスである必要があります。このパラメーターは必須であり、NULL に設定することはできません。

[in] CallbackData

以前に同期された I/O 操作からのコールバックデータ (FLT_CALLBACK_DATA) 構造体へのポインター。このパラメーターは必須であり、NULL に設定することはできません。

戻り値

なし

解説

ミニフィルタードライバーは、同期された I/O 要求を再発行する事後コールバック (PFLT_POST_OPERATION_CALLBACK) ルーチンから FltReissueSynchronousIo を呼び出します。通常、別のパラメーターで失敗した操作を再発行したり、再解析バウンスを処理したりするために、Postoperation コールバックルーチンから FltReissueSynchronousIo を呼び出します。ただし、 FltReissueSynchronousIo を呼び出して、 FltAllocateCallbackData ルーチンと FltPerformSynchronousIo ルーチンの呼び出しによってミニフィルタードライバーが生成した I/O を再発行することもできます。この状況では、Postoperation コールバックルーチンで FltReissueSynchronousIo を呼び出すか、操作コールバックルーチンのコンテキスト外で呼び出すかは関係ありません。 postoperation コールバックルーチンのコンテキスト外の呼び出しの場合は、代わりに FltReuseCallbackData ルーチンと FltPerformSynchronousIo ルーチンの使用を検討してください。

呼び出し元は、I/O 要求を再発行する前に、コールバックデータ (FLT_CALLBACK_DATA) 構造体の I/O パラメーターブロックの内容を変更できます。その場合は、FltReissueSynchronousIo を呼び出す前に FltSetCallbackDataDirty を呼び出す必要があります。

たとえば、ミニフィルタードライバーが再解析ポイントを使用し、その作成後のコールバックルーチンが、STATUS_REPARSEを返した作成操作に対して呼び出された場合、ミニフィルタードライバーは、独自の再解析ポイントの作成操作を再発行できます。この場合、ミニフィルタードライバーは次の手順を完了します。

コールバックデータ構造体の I/O パラメーターブロックで、FILE_OPEN_REPARSE_POINT フラグを設定します。
FltSetCallbackDataDirty を呼び出します。
FltReissueSynchronousIo を呼び出して、作成要求を再発行します。

フィルターマネージャーは、( InitiatingInstance パラメーターで指定された) 開始インスタンスの下にアタッチされているミニフィルタードライバーインスタンスとファイルシステムにのみ、再発行された I/O 要求を送信します。開始インスタンスの上にアタッチされたミニフィルタードライバーインスタンスは、再発行された I/O 要求を受け取りません。

同期された I/O 操作のみを再発行できます。ドライバーに再発行機能を提供するには、postoperation コールバックルーチンで FltReissueSynchronousIo を 呼び出すことによって、ミニフィルタードライバーは、プリ操作コールバックルーチンでFLT_PREOP_SYNCHRONIZEを明示的に返す必要があります。

注意

ミニフィルタードライバーは 、FltIsOperationSynchronous ルーチンを呼び出して、この操作の事前操作コールバックルーチンがFLT_PREOP_SYNCHRONIZE返されたかどうかを判断しません。ミニフィルタードライバーは FltIsOperationSynchronous を呼び出して、操作自体が I/O マネージャーの観点から同期しているかどうかを判断します。

IRP ベースの I/O 操作のみを再発行できます。高速 I/O 操作とファイルシステムフィルター (FSFilter) コールバック操作は再発行できません。 I/O 操作が IRP ベースであるかどうかを判断するには、 FLT_IS_IRP_OPERATION マクロを使用します。

取り消された作成 (IRP_MJ_CREATE) 操作は再発行できません。作成操作に対して FltReissueSynchronousIo を呼び出す前に、呼び出し元は作成操作のファイルオブジェクトの Flags メンバーをチェックする必要があります。 FO_FILE_OPEN_CANCELLED フラグが設定されている場合は、作成操作が取り消され、このファイルオブジェクトに対してクローズ (IRP_MJ_CLOSE) 操作が発行されることを意味します。取り消された作成操作に対して FltReissueSynchronousIo が呼び出された場合、フィルターマネージャーは再発行された I/O 要求をSTATUS_CANCELLEDで失敗します。

注意

ミニフィルタードライバーが作成後のコールバックで作成を再発行する場合、再解析ポイント (CallbackData の TagData フィールド) に関連付けられているバッファーを解放して NULL に設定する必要はありません。代わりに、フィルターマネージャーはバッファーを解放し、それらに対して NULL に設定します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Update Rollup 1 for SP4;Windows XP SP2
サポートされている最小のサーバー	Windows Server 2003 SP1
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (FltKernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	<= APC_LEVEL (非ページング IO はPASSIVE_LEVELでのみ再発行できます)