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

FltClose

FltCreateFile

FltQueryInformationFile

FltQueryVolumeInformation

FltReadFile

FltSetInformationFile

FltSetVolumeInformation

FltTagFile

FltUntagFile

FltWriteFile

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

要求

要求
目标平台 通用
标头 fltkernel.h (包括 Fltkernel.h)
Library FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

另请参阅

FLT_CALLBACK_DATA

FltAllocateCallbackData

FltClose

FltCreateFile

FltFreeCallbackData

FltPerformAsynchronousIo

FltQueryInformationFile

FltQueryVolumeInformation

FltReadFile

FltReissueSynchronousIo

FltReuseCallbackData

FltSetInformationFile

FltSetVolumeInformation

FltTagFile

FltUntagFile

FltWriteFile