FltCbdqRemoveIo 関数 (fltkernel.h)

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

FltCbdqRemoveIo は、ミニフィルタードライバーのコールバックデータキューから特定の項目を削除します。

構文

PFLT_CALLBACK_DATA FLTAPI FltCbdqRemoveIo(
  [in, out] PFLT_CALLBACK_DATA_QUEUE            Cbdq,
  [in]      PFLT_CALLBACK_DATA_QUEUE_IO_CONTEXT Context
);

パラメーター

[in, out] Cbdq

キャンセルセーフなコールバックデータキューへのポインター。このキューは、FltCbdqInitialize を呼び出して初期化されている必要があります。

[in] Context

削除する項目のコンテキストポインター。このコンテキストは、I/O 要求がキューに最初に挿入されるときに FltCbdqInsertIo によって初期化されます。このパラメーターは必須であり、NULL 以外である必要があります。

戻り値

FltCbdqRemoveIo は、キューから削除された I/O 要求のコールバックデータ構造へのポインターを返します。一致する I/O 要求が見つからない場合、またはキューが空の場合、 FltCbdqRemoveIo はNULL を返します。

注釈

FltCbdqRemoveIo は、ミニフィルタードライバーのコールバックデータキューから特定の I/O 操作のコールバックデータ (FLT_CALLBACK_DATA) 構造体を削除します。 FltCbdqRemoveIo は、 Context 構造体が関連付けられているコールバックデータ構造の削除にのみ使用できます。この関連付けは、コールバックデータ構造が FltCbdqInsertIo によってコールバックデータキューに挿入されるときに作成されます。

ミニフィルタードライバーは 、FltCbdqXxx ルーチンを使用して、IRP ベースの I/O 操作のコールバックデータキューを実装できます。これらのルーチンを使用すると、ミニフィルタードライバーは、キューをキャンセルセーフにすることができます。システムは、ミニフィルタードライバーの I/O キャンセルを透過的に処理します。

FltCbdqXxx ルーチンは、IRP ベースの I/O 操作にのみ使用できます。特定のコールバックデータ構造が IRP ベースの I/O 操作を表すかどうかを確認するには、 FLT_IS_IRP_OPERATION マクロを使用します。

コールバックデータキューは、FltCbdqInitialize によって初期化されます。 FltCbdqRemoveIo は、キューのディスパッチテーブルに用意されているルーチンを使用してキューをロックし、キューからコールバックデータ構造を削除します。削除操作自体は、ミニフィルタードライバーの CbdqRemoveIo コールバックルーチンによって実行されます。

キューがミューテックスオブジェクトまたはリソース変数ではなくスピンロックによって保護されている場合、FltCbdqRemoveIo の呼び出し元は IRQL <= DISPATCH_LEVELで実行できます。ミューテックスまたはリソースを使用する場合、呼び出し元は IRQL <= APC_LEVELで実行されている必要があります。

取り消された I/O 要求を削除するフィルターマネージャーと、フィルタードライバーが完了したために削除する間に競合が発生する可能性があります。要求コンテキストは最初に削除された後も有効なままであり、2 回目の削除試行が失敗する可能性があることに注意してください。