FltCbdqDisable 函数 (fltkernel.h)

FltCbdqDisable 禁用微型筛选器驱动程序的回调数据队列。

语法

VOID FLTAPI FltCbdqDisable(
  [in, out] PFLT_CALLBACK_DATA_QUEUE Cbdq
);

参数

[in, out] Cbdq

指向回调数据队列的指针。

返回值

没有

言论

FltCbdqDisable 禁用回调数据队列,以便无法向其中添加更多项。

微型筛选器驱动程序可以使用 FltCbdqXxx 例程来实现基于 IRP 的 I/O作的回调数据队列。 使用这些例程,微型筛选器驱动程序可以使其队列取消安全;系统以透明方式处理微型筛选器驱动程序的 I/O 取消。

FltCbdqXxx 例程只能用于基于 IRP 的 I/O作。 若要确定给定的回调数据结构是否表示基于 IRP 的 I/O作,请使用 FLT_IS_IRP_OPERATION 宏。

微型筛选器驱动程序通常在实例拆解或微型筛选器驱动程序卸载期间调用 FltCbdqDisable。 调用此例程后,微型筛选器驱动程序应清空,或 排空队列。 为此,可以重复调用 FltCbdqRemoveNextIo,直到队列中不再保留任何项。

有关如何创建回调数据队列的详细信息,请参阅 FltCbdqInitialize。 使用 FltCbdqInsertIo 向队列添加 I/O 请求。 使用 FltCbdqRemoveIo 从队列中删除特定 I/O 请求,或 FltCbdqRemoveNextIo 删除下一个可用的 I/O 请求。

若要在禁用队列后重新启用队列,请调用 FltCbdqEnable

如果队列受 旋转锁 保护,而不是 互斥对象资源变量,则可以在 IRQL <= DISPATCH_LEVEL 上运行 FltCbdqDisable 的调用方。 如果使用互斥体或资源,则调用方必须在 IRQL <= APC_LEVEL运行。

要求

要求 价值
目标平台 普遍
标头 fltkernel.h (包括 Fltkernel.h)
IRQL 请参阅“备注”部分。

另请参阅

FLT_CALLBACK_DATA_QUEUE

FLT_IS_IRP_OPERATION

FltCbdqEnable

FltCbdqInitialize

FltCbdqInsertIo

FltCbdqRemoveIo

FltCbdqRemoveNextIo