Fungsi ZwFlushBuffersFile (ntifs.h)

  • Artikel

Rutinitas ZwFlushBuffersFile dipanggil oleh driver filter sistem file untuk mengirim permintaan flush untuk file yang ditentukan ke sistem file.

Sintaks

NTSYSAPI NTSTATUS ZwFlushBuffersFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock
);

Parameter

[in] FileHandle

Tangani yang dikembalikan oleh ZwCreateFile atau ZwOpenFile untuk file yang buffernya akan dihapus. Parameter ini diperlukan dan tidak boleh NULL.

[out] IoStatusBlock

Alamat blok status I/O penelepon. Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

ZwFlushBuffersFile 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 tulis; ini adalah kode kesalahan.
STATUS_VOLUME_DISMOUNTED
 File berada pada volume yang saat ini tidak dipasang; ini adalah kode kesalahan.

Keterangan

Driver filter sistem file dapat memanggil ZwFlushBuffersFile untuk mengeluarkan permintaan IRP_MJ_FLUSH_BUFFERS ke sistem file untuk file tertentu. Operasi flush sinkron.

Driver minifilter harus memanggil FltFlushBuffers alih-alih memanggil ZwFlushBuffersFile.

Penelepon ZwFlushBuffersFile harus berjalan di IRQL = PASSIVE_LEVEL dan dengan APC kernel khusus diaktifkan.

Catatan Jika panggilan ke fungsi ZwFlushBuffersFile terjadi dalam mode pengguna, Anda harus menggunakan nama "NtFlushBuffersFile" alih-alih "ZwFlushBuffersFile".
 
Untuk panggilan dari driver mode kernel, versi **Nt*Xxx*** dan **Zw*Xxx*** dari rutinitas Windows Native System Services dapat berperilaku berbeda dengan cara mereka menangani dan menginterpretasikan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi **Nt*Xxx*** dan **Zw*Xxx*** dari rutinitas, lihat [Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli](/windows-hardware/drivers/kernel/using-nt-and-zw-versions-of-the-native-system-services-routines).

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL (lihat bagian Keterangan)
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

FltFlushBuffers

IRP_MJ_FLUSH_BUFFERS

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwCreateFile

ZwOpenFile