微型筛选器驱动程序调用 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:
FltPerformSynchronousIo 返回后,调用方可以通过调用 FltReissueSynchronousIo重新发出 I/O作。 或者,调用方可以通过调用 FltFreeCallbackData 来释放回调数据(FLT_CALLBACK_DATA)结构,或者通过调用 FltReuseCallbackData来准备重新使用。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 标头 | fltkernel.h (包括 Fltkernel.h) |
| 库 | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |