FltCbdqInsertIo 関数 (fltkernel.h)

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

FltCbdqInsertIo は、I/O 操作のコールバックデータ構造をフィルタードライバーのコールバックデータキューに挿入します。

構文

NTSTATUS FLTAPI FltCbdqInsertIo(
  [in, out]      PFLT_CALLBACK_DATA_QUEUE            Cbdq,
  [in]           PFLT_CALLBACK_DATA                  Cbd,
  [in, optional] PFLT_CALLBACK_DATA_QUEUE_IO_CONTEXT Context,
  [in, optional] PVOID                               InsertContext
);

パラメーター

[in, out] Cbdq

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

[in] Cbd

キューに入る I/O 操作のコールバックデータ (FLT_CALLBACK_DATA) 構造体へのポインター。操作は IRP ベースの I/O 操作である必要があります。

[in, optional] Context

I/O 要求の不透明なコンテキストポインターを受け取る呼び出し元が指定した変数。フィルタードライバーは、 FltCbdqRemoveIo を呼び出して削除できるように、このポインターを使用してキュー内の特定の項目を識別できます。フィルタードライバーがキューから特定の I/O 要求を削除する必要がない場合、このパラメーターは NULL にすることができます。

[in, optional] InsertContext

フィルタードライバーの CbdqInsertIo コールバックルーチンに渡されるコンテキストポインター。

戻り値

FltCbdqInsertIo は、コールバックデータ構造がコールバックデータキューに挿入されたときのSTATUS_SUCCESS、または次のような適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_FLT_CBDQ_DISABLED	コールバックデータ構造は、現在キューが無効になっているため、コールバックデータキューに挿入されませんでした。キューを再度登録するには、 FltCbdqEnable を呼び出します。これはエラーコードです。

注意

成功した場合、 FltCbdqInsertIo は フィルターの InsertIo コールバックが返す内容を返します。たとえば、フィルターは成功を示すためにSTATUS_SUCCESSまたはSTATUS_PENDINGを返す場合があります。フィルターは、成功を示すために使用する値に対して自己一貫性を保つ必要があります。

注釈

FltCbdqInsertIo は 、指定したコールバックデータ (FLT_CALLBACK_DATA) 構造体をフィルタードライバーのコールバックデータキューに挿入します。

コールバックデータを挿入するフィルタードライバーと、関連付けられている IRP が取り消される間に競合状態が発生する可能性があることに注意してください。これは、IRP が既に取り消されている場合にキューのキャンセルルーチンをすぐに呼び出すことによって回避できます。

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

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

コールバックデータキューは、 FltCbdqInitialize を呼び出すことによって初期化されます。 FltCbdqInsertIo は、キューのディスパッチテーブルに用意されている関数を使用してキューをロックし、コールバックデータ構造をキューに挿入します。挿入操作自体は、キューの CbdqInsertIo ルーチンによって実行されます。

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

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