FltPerformSynchronousIo 函式 (fltkernel.h)

發行項
02/29/2024

迷你篩選驅動程式會呼叫 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 作業。

Minifilter 驅動程式只有在無法使用下列例程的情況下，才應該使用 FltPerformSynchronousIo ：

FltClose

FltCreateFile

FltQueryInformationFile

FltQueryVolumeInformation

FltReadFile

FltSetInformationFile

FltSetVolumeInformation

FltTagFile

FltUntagFile

FltWriteFile

在 FltPerformSynchronousIo 傳回之後，呼叫端可以藉由呼叫 FltReissueSynchronousIo 重新發出 I/O 作業。或者，呼叫端可以藉由呼叫 FltFreeCallbackData 來釋放回呼數據 (FLT_CALLBACK_DATA) 結構，或呼叫 FltReuseCallbackData 來準備重複使用回呼數據。