FltPerformSynchronousIo 函数 (fltkernel.h)

微筛选器驱动程序调用 FltPerformSynchronousIo 以在调用 FltAllocateCallbackData 为操作分配回调数据结构后启动同步 I/O 操作。

语法

VOID FLTAPI FltPerformSynchronousIo(
  [in, out] PFLT_CALLBACK_DATA CallbackData
);

[in, out] CallbackData

指向回调数据的指针 (FLT_CALLBACK_DATA) 上一次调用 FltAllocateCallbackData 分配的结构。此参数是必需的，不能为 NULL。调用方负责通过调用 FltFreeCallbackData 不再需要此结构时释放此结构。

无

微筛选器驱动程序调用 FltPerformSynchronousIo 来启动同步 I/O 操作。

微筛选器驱动程序只能启动基于 IRP 的 I/O 操作。它们无法启动快速 I/O 或文件系统筛选器 (FSFilter) 回调操作。

FltPerformSynchronousIo 仅将 I/O 操作发送到在 实例参数中指定的 启动实例 (下附加到 FltAllocateCallbackData) 和文件系统的微筛选器驱动程序实例。附加到指定实例上方的微筛选器驱动程序不会接收 I/O 操作。

仅当不能使用以下例程时，微型筛选器驱动程序才应使用 FltPerformSynchronousIo ：

FltPerformSynchronousIo 返回后，调用方可以通过调用 FltReissueSynchronousIo 重新发出 I/O 操作。或者，调用方可以通过调用 FltFreeCallbackData 释放回调数据 (FLT_CALLBACK_DATA) 结构，或通过调用 FltReuseCallbackData 来准备重用它。