FltCbdqRemoveNextIo 函式（fltkernel.h）

發行項
02/06/2025

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 準則的意義完全相依於迷你篩選驅動程式。

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