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 | 請參閱一節。 |