FltCbdqDisable 関数 (fltkernel.h)

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

FltCbdqDisable は、ミニフィルタードライバーのコールバックデータキューを無効にします。

構文

VOID FLTAPI FltCbdqDisable(
  [in, out] PFLT_CALLBACK_DATA_QUEUE Cbdq
);

パラメーター

[in, out] Cbdq

コールバックデータキューへのポインター。

戻り値

なし

解説

FltCbdqDisable はコールバックデータキューを無効にして、それ以上項目を追加できないようにします。

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

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

ミニフィルタードライバーは通常、インスタンスの破棄またはミニフィルタードライバーのアンロード中 に FltCbdqDisable を呼び出します。このルーチンを呼び出した後、ミニフィルタードライバーはキューを空にするか、 ドレインする必要があります。これは、これ以上項目がキューに残らなくなるまで、FltCbdqRemoveNextIo を繰り返し呼び出すことによって行うことができます。

コールバックデータキューを作成する方法の詳細については、「 FltCbdqInitialize 」を参照してください。 FltCbdqInsertIo を使用して、キューに I/O 要求を追加します。特定の I/O 要求をキューから削除するには FltCbdqRemoveIo を使用し、次に使用可能な I/O 要求を削除するには FltCbdqRemoveNextIo を使用します。

無効にした後でキューを再度有効にするには、 FltCbdqEnable を呼び出します。

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