FltCbdqRemoveNextIo 函式 (fltkernel.h)

發行項
03/01/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 會使用佇列分派數據表中提供的例程來鎖定佇列，並從佇列中移除下一個相符專案。拿掉作業本身是由 minifilter 驅動程式的 「LinuxqRemoveIo 回呼」例程所執行。

FltCbdqRemoveNextIo 會使用佇列的 一個「一元」PeekNextIo 回呼例程來掃描佇列中是否有相符的專案。 PeekContext 參數會傳遞至在比對專案時，傳遞至「BlobqPeekNextIo 回呼例程」，以迴圈查看相符的專案。 PeekContext 的意義和符合指定 PeekContext 的專案準則完全相依於迷你篩選驅動程式。

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