FltCbdqRemoveIo 函式（fltkernel.h）

發行項
02/06/2025

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 回呼例程來執行。

如果佇列受到微調鎖定保護，而不是 mutex 物件或資源變數，FltCbdqRemoveIo 的呼叫者可以在 IRQL <= DISPATCH_LEVEL 執行。如果使用 mutex 或資源，呼叫端必須在 IRQL <= APC_LEVEL執行。

篩選管理員移除已取消的 I/O 要求，以及篩選驅動程式因為已完成而移除它之間可能會發生競爭。請務必注意，要求內容在第一次移除之後仍然有效，這會導致第二次移除嘗試失敗。