FltFlushBuffers2 函式 (fltkernel.h)
小型篩選驅動程式會呼叫 FltFlushBuffers2,以將排清要求傳送給指定檔案的文件系統。
語法
NTSTATUS FLTAPI FltFlushBuffers2(
PFLT_INSTANCE Instance,
PFILE_OBJECT FileObject,
ULONG FlushType,
PFLT_CALLBACK_DATA CallbackData
);
參數
Instance
[in]呼叫迷你篩選驅動程序實例的不透明實例指標。 這是必要參數,而且不能是 NULL。
FileObject
[in]要排清之檔案或磁碟區的檔案對象指標。 這是必要參數,而且不能是 NULL。
FlushType
[in]指定檔案系統應該在檔案上執行的排清類型。 FlushType 可以是下列其中一項:
FlushType 作業值 | 描述 |
---|---|
0 | 如果 fileObject 適用於檔案,則會寫入檔案快取中的檔案數據和元數據,並將同步處理基礎記憶體來排清其快取。 如果 FileObject 適用於磁碟區,檔系統將會寫入磁碟區上所有已修改檔案的檔案數據和元數據,並將基礎記憶體同步處理以排清其快取。 此作業相當於 FltFlushBuffers。 |
FLT_FLUSH_TYPE_FLUSH_AND_PURGE | 與 0 相同(FltFlushBuffers),不同之處在於快取也會在排清完成之後清除。 |
FLT_FLUSH_TYPE_FILE_DATA_ONLY | 如果檔案位於NTFS檔案系統上,則只會寫入檔案快取中的檔案數據。 不會寫入任何元數據,而且基礎記憶體不會同步處理以排清其快取。 如果 FileObject 適用於磁碟區,則這個旗標無效。 |
FLT_FLUSH_TYPE_NO_SYNC | 如果檔案位於NTFS檔系統上,則會寫入檔案快取中的檔案數據和元數據。 基礎記憶體不會同步處理以排清其快取。 如果 FileObject 適用於磁碟區,則這個旗標無效。 |
FLT_FLUSH_TYPE_DATA_SYNC_ONLY | 如果檔案位於NTFS檔案系統上,則會寫入檔案快取中的檔案數據。 未寫入任何元數據。 基礎記憶體會同步處理以排清其快取。 如果 fileObject 磁碟區或目錄,則這個旗標無效。 |
CallbackData
[in/optional]選擇性 FLT_CALLBACK_DATA 結構的指標,用來傳播呼叫端的 IRP 延伸模組。 請參閱 FltPropagateIrpExtension。
傳回值
FltFlushBuffers2 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值,例如下列其中一項:
傳回碼 | 描述 |
---|---|
STATUS_MEDIA_WRITE_PROTECTED | 檔案位於寫入保護的磁碟區上。 這是錯誤碼。 |
STATUS_VOLUME_DISMOUNTED | 檔案位於目前未掛接的磁碟區上。 這是錯誤碼。 |
言論
小型篩選驅動程式可以呼叫 FltFlushBuffers2,對指定的檔案向文件系統發出 IRP_MJ_FLUSH_BUFFERS 要求。 排清作業是同步的,而且會在指定的實例 下方發出實例。
如果檔案位於NTFS文件系統上,迷你篩選程式可以透過 FlushType 參數控制排清的類型。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1903 |
標頭 | fltkernel.h |