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 作業傳送至附加在起始實例下方的小型篩選驅動程序實例(Instance 參數中所指定,以 FltAllocateCallbackData),以及文件系統。 附加在指定實例上方的迷你篩選驅動程式不會收到I/O 作業。
小型篩選驅動程式應該使用 FltPerformSynchronousIo,只有在無法使用下列例程的情況下:
FltPerformSynchronousIo 傳回之後,呼叫端可以呼叫 FltReissueSynchronousIo重新發出 I/O 作業。 或者,呼叫者可以呼叫 fltFreeCallbackData ,或 呼叫 fltReuseCallbackData來準備重複使用回呼數據 (FLT_CALLBACK_DATA) 結構。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | fltkernel.h (包括 Fltkernel.h) |
連結庫 | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |