FltCbdqInsertIo 函数 (fltkernel.h)

FltCbdqInsertIo 将 I/O 操作的回调数据结构插入到筛选器驱动程序的回调数据队列中。

语法

NTSTATUS FLTAPI FltCbdqInsertIo(
  [in, out]      PFLT_CALLBACK_DATA_QUEUE            Cbdq,
  [in]           PFLT_CALLBACK_DATA                  Cbd,
  [in, optional] PFLT_CALLBACK_DATA_QUEUE_IO_CONTEXT Context,
  [in, optional] PVOID                               InsertContext
);

参数

[in, out] Cbdq

指向调用方取消安全回调数据队列的指针。 必须通过调用 FltCbdqInitialize 来初始化此队列。

[in] Cbd

指向要排队的 I/O 操作的回调数据 (FLT_CALLBACK_DATA) 结构的指针。 该操作必须是基于 IRP 的 I/O 操作。

[in, optional] Context

调用方提供的变量,该变量接收 I/O 请求的不透明上下文指针。 筛选器驱动程序可以使用此指针来标识队列中的特定项,以便可以通过调用 FltCbdqRemoveIo 将其删除。 如果筛选器驱动程序不需要从队列中删除特定的 I/O 请求,此参数可以为 NULL

[in, optional] InsertContext

要传递给筛选器驱动程序 的 CbdqInsertIo 回调例程的上下文指针。

返回值

FltCbdqInsertIo 在回调数据队列中插入回调数据结构或相应的 NTSTATUS 值(如以下内容)时返回STATUS_SUCCESS:

返回代码 说明
STATUS_FLT_CBDQ_DISABLED 回调数据结构未插入回调数据队列,因为队列当前已禁用。 若要重新启用队列,请调用 FltCbdqEnable。 这是一个错误代码。

注意

成功时, FltCbdqInsertIo 返回筛选器的 InsertIo 回调返回的任何内容;例如,筛选器可能会返回STATUS_SUCCESS或STATUS_PENDING来指示成功。 对于它用来指示成功的值,筛选器必须保持自我一致。

备注

FltCbdqInsertIo 将指定的回调数据 (FLT_CALLBACK_DATA) 结构插入到筛选器驱动程序的回调数据队列中。

  • 请注意,在插入回调数据的筛选器驱动程序与正在取消的关联 IRP 之间可能存在争用条件。 如果 IRP 已取消,可以立即调用队列的取消例程来避免此问题。

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

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

通过调用 FltCbdqInitialize 初始化回调数据队列。 FltCbdqInsertIo 使用队列调度表中提供的函数锁定队列并将回调数据结构插入队列。 插入操作本身由队列的 CbdqInsertIo 例程执行。

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

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

要求

   
目标平台 通用
标头 fltkernel.h (包括 Fltkernel.h)
IRQL 请参阅“备注”部分。

另请参阅

FLT_CALLBACK_DATA

FLT_CALLBACK_DATA_QUEUE

FLT_IS_IRP_OPERATION

FltCbdqDisable

FltCbdqEnable

FltCbdqInitialize

FltCbdqRemoveIo

FltCbdqRemoveNextIo