FltCancelIo 関数 (fltkernel.h)

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

FltCancelIo ルーチンは、I/O 操作を取り消します。

構文

BOOLEAN FLTAPI FltCancelIo(
  [in] PFLT_CALLBACK_DATA CallbackData
);

パラメーター

[in] CallbackData

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

戻り値

FltCancelIo は、I/O 操作が正常に取り消された場合に TRUE を 返します。それ以外の場合は、 FALSE を返します。

注釈

FltPerformAsynchronousIo などのルーチンを呼び出して I/O 操作を開始するミニフィルタードライバーは、FltCancelIo を呼び出すことによって操作を取り消すことができます。操作は IRP ベースの I/O 操作である必要があります。ミニフィルタードライバーの独自の作業キューに現在ポストされていない必要があり、完了していない必要があります。

IRP にキャンセルルーチンがある場合、 FltCancelIo は IRP のキャンセルビットを設定し、キャンセルルーチンを呼び出します。

IRP にキャンセルルーチンがないため、IRP が取り消し可能でない場合、 FltCancelIo は IRP のキャンセルビットを設定し、 FALSE を返します。 IRP は、取り消し可能になったときに後で取り消す必要があります。

IRP ベースの I/O 操作を開始しなかったミニフィルタードライバーが FltCancelIo を呼び出した場合、結果は予測できません。たとえば、取り消しビットが設定されていても、成功した NTSTATUS コードで IRP が完了する可能性があります。

FltCancelIo は、次のいずれかの条件が満たされている場合に FALSE を 返します。