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 来准备重用它。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | fltkernel.h (包括 Fltkernel.h) |
Library | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |