FltPerformSynchronousIo 函数 (fltkernel.h)

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

语法

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

参数

[in, out] CallbackData

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

返回值

没有

言论

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

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

FltPerformSynchronousIo 仅将 I/O作发送到附加到启动实例下方的微型筛选器驱动程序实例(在 Instance 参数中指定的 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)
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