共用方式為


FltCbdqRemoveIo 函式 (fltkernel.h)

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 只能用來刪除回呼數據結構,該結構具有與其相關聯的 內容 結構。 當 FltCbdqInsertIo 插入回呼數據佇列時,就會建立此關聯。

迷你篩選驅動程式可以使用 FltCbdqXxx 例程來實作 IRP 型 I/O 作業的回呼數據佇列。 使用這些例程,迷你篩選驅動程式可以讓佇列取消安全;系統會以透明方式處理迷你篩選驅動程式的 I/O 取消。

FltCbdqXxx 例程只能用於 IRP 型 I/O 作業。 若要判斷指定的回呼數據結構是否代表以 IRP 為基礎的 I/O 作業,請使用 FLT_IS_IRP_OPERATION 宏。

回呼數據佇列是由 FltCbdqInitialize 初始化。 FltCbdqRemoveIo 會使用佇列分派數據表中提供的例程來鎖定佇列,並從佇列中移除回呼數據結構。 拿掉作業本身是由 minifilter 驅動程式的 「LinuxqRemoveIo 回呼」例程所執行。

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

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

規格需求

需求
目標平台 Universal
標頭 fltkernel.h (包含 Fltkernel.h)
IRQL 請參閱一節。

另請參閱

FLT_CALLBACK_DATA

FLT_CALLBACK_DATA_QUEUE

FLT_IS_IRP_OPERATION

FltCbdqDisable

FltCbdqEnable

FltCbdqInitialize

FltCbdqInsertIo

FltCbdqRemoveNextIo