Fungsi FltFlushBuffers (fltkernel.h)

Artikel
02/29/2024

Rutinitas FltFlushBuffers digunakan oleh driver minifilter untuk mengirim permintaan flush untuk file tertentu ke sistem file. Gunakan FltFlushBuffers2 untuk menentukan opsi jenis flush yang berbeda.

Sintaks

NTSTATUS FLTAPI FltFlushBuffers(
  [in] PFLT_INSTANCE Instance,
  [in] PFILE_OBJECT  FileObject
);

Parameter

[in] Instance

Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

[in] FileObject

Penunjuk objek file untuk file yang akan dihapus. Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

FltFlushBuffers mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_MEDIA_WRITE_PROTECTED	File berada pada volume yang dilindungi penulisan. Ini adalah kode kesalahan.
STATUS_VOLUME_DISMOUNTED	File berada pada volume yang saat ini tidak dipasang. Ini adalah kode kesalahan.

Keterangan

Driver minifilter dapat memanggil FltFlushBuffers untuk mengeluarkan permintaan IRP_MJ_FLUSH_BUFFERS ke sistem file untuk file tertentu. Operasi flush sinkron dan dikeluarkan untuk instans di bawah Instans yang ditentukan.

Jika FileObject adalah untuk file, data file dan metadata dalam cache file akan ditulis, dan penyimpanan yang mendasar akan disinkronkan untuk membersihkan cache-nya. Jika FileObject adalah untuk volume, sistem file akan menyebabkan data file dan metadata untuk semua file yang dimodifikasi pada volume akan ditulis, dan penyimpanan yang mendasar akan disinkronkan untuk membersihkan cache-nya. Gunakan FltFlushBuffers2 untuk lebih terperinci mengontrol jenis flush yang harus dilakukan sistem file.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	FltMgr.lib
IRQL	PASSIVE_LEVEL

Lihat juga

FltFlushBuffers2

IRP_MJ_FLUSH_BUFFERS

Bagikan melalui