FltCbdqRemoveNextIo 関数 (fltkernel.h)

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

FltCbdqRemoveNextIo は 、ミニフィルタードライバーのコールバックデータキュー内の次に一致する項目を削除します。

構文

PFLT_CALLBACK_DATA FLTAPI FltCbdqRemoveNextIo(
  [in, out]      PFLT_CALLBACK_DATA_QUEUE Cbdq,
  [in, optional] PVOID                    PeekContext
);

パラメーター

[in, out] Cbdq

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

[in, optional] PeekContext

一致する項目を識別する呼び出し元定義情報へのポインター。このパラメーターは省略可能であり、 NULL にすることができます。

戻り値

FltCbdqRemoveNextIo は、キューから削除されたアイテムのコールバックデータ (FLT_CALLBACK_DATA) 構造体へのポインターを返します。一致する項目が見つからなかった場合は NULL を 返します。 FltCbdqRemoveNextIo は、まだ取り消されていない I/O 操作の項目のみを返します。

注釈

FltCbdqRemoveNextIo は、 ミニフィルタードライバーのコールバックデータキューから次に一致する項目を削除します。

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

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

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

FltCbdqRemoveNextIo は 、キューの CbdqPeekNextIo コールバックルーチンを使用して、一致する項目のキューをスキャンします。 PeekContext パラメーターは、一致する項目をループ処理するために、CbdqPeekNextIo コールバックルーチンに渡されます。 PeekContext の意味と、特定の PeekContext に一致する項目の条件は、ミニフィルタードライバーに完全に依存します。

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