Fungsi FsRtlRegisterFileSystemFilterCallbacks (ntifs.h)

  • Artikel

Driver filter sistem file dan sistem file memanggil rutinitas FsRtlRegisterFileSystemFilterCallbacks untuk mendaftarkan rutinitas panggilan balik pemberitahuan untuk dipanggil ketika sistem file yang mendasarinya melakukan operasi tertentu.

Sintaks

NTSTATUS FsRtlRegisterFileSystemFilterCallbacks(
  [in] _DRIVER_OBJECT       *FilterDriverObject,
  [in] PFS_FILTER_CALLBACKS Callbacks
);

Parameter

[in] FilterDriverObject

Penunjuk ke objek pengandar untuk filter atau driver sistem file.

[in] Callbacks

Penunjuk ke struktur FS_FILTER_CALLBACKS yang berisi titik masuk rutinitas panggilan balik pemberitahuan yang disediakan penelepon. Semua titik masuk panggilan balik bersifat opsional dan dapat diatur ke NULL.

Nilai kembali

Rutinitas FsRtlRegisterFileSystemFilterCallbacks dapat mengembalikan salah satu nilai status berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS Rutinitas panggilan balik berhasil didaftarkan.
STATUS_INSUFFICIENT_RESOURCES FsRtlRegisterFileSystemFilterCallbacks mengalami kegagalan alokasi kumpulan saat mengalokasikan memori untuk menyimpan informasi panggilan balik.
STATUS_FSFILTER_OP_COMPLETED_SUCCESSFULLY FsRtlRegisterFileSystemFilterCallbacks berhasil menyelesaikan operasi FsFilter.
STATUS_FILE_LOCKED_WITH_ONLY_READERS File dikunci dan semua pengguna file hanya dapat membaca.
STATUS_FILE_LOCKED_WITH_WRITERS File dikunci dan setidaknya satu pengguna file dapat menulis
STATUS_INVALID_PARAMETER Salah satu parameter tidak valid.

Keterangan

Sistem file dan driver filter sistem file harus memanggil FsRtlRegisterFileSystemFilterCallbacks dari rutinitas DriverEntry driver.

FsRtlRegisterFileSystemFilterCallbacks mendaftarkan rutinitas panggilan balik pemberitahuan yang ditentukan dalam parameter Callback yang akan dipanggil ketika permintaan untuk operasi file tertentu dikirim ke sistem file yang mendasarinya.

Sistem file memanggil FsRtlRegisterFileSystemFilterCallbacks untuk mengatur anggota panggilan balik PreAcquireForSectionSynchronization dari struktur FS_FILTER_CALLBACKS alih-alih menggunakan AcquireFileForNtCreateSection yang sudah usang.

Rutinitas panggilan balik yang didaftarkan oleh FsRtlRegisterFileSystemFilterCallbacks menggantikan rutinitas panggilan balik I/O cepat berikut, yang usang dan tidak boleh digunakan oleh driver filter sistem file:

  • AcquireForCcFlush
  • AcquireFileForNtCreateSection
  • AcquireForModWrite
  • ReleaseForCcFlush
  • ReleaseFileForNtCreateSection
  • ReleaseForModWrite

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Lihat juga

FS_FILTER_CALLBACKS