Fungsi IoRegisterFsRegistrationChangeMountAware (ntifs.h)

Artikel
03/08/2023

Rutinitas IoRegisterFsRegistrationChangeMountAware mendaftarkan rutinitas pemberitahuan driver filter sistem file. Rutinitas pemberitahuan ini dipanggil setiap kali sistem file mendaftar atau membatalkan pendaftaran dirinya sebagai sistem file aktif.

Sintaks

NTSTATUS IoRegisterFsRegistrationChangeMountAware(
  [in] PDRIVER_OBJECT          DriverObject,
  [in] PDRIVER_FS_NOTIFICATION DriverNotificationRoutine,
  [in] BOOLEAN                 SynchronizeWithMounts
);

Parameter

[in] DriverObject

Penunjuk ke objek driver untuk driver filter sistem file.

[in] DriverNotificationRoutine

Penunjuk ke rutinitas PDRIVER_FS_NOTIFICATION , yang dipanggil sistem file ketika mendaftar atau membatalkan pendaftaran itu sendiri.

[in] SynchronizeWithMounts

Jika diatur ke TRUE, rutinitas ini memastikan tidak ada operasi pemasangan yang sedang berlangsung saat melakukan panggilan balik pemberitahuan. Jika diatur ke FALSE, rutinitas tidak mencoba menghindari konflik dengan operasi pemasangan.

Nilai kembali

Mengembalikan salah satu nilai NTSTATUS berikut ini:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Rutinitas pemberitahuan berhasil didaftarkan.
STATUS_INSUFFICIENT_RESOURCES	Paket pemberitahuan tidak dapat dialokasikan untuk rutinitas pemberitahuan.
STATUS_DEVICE_ALREADY_ATTACHED	Obyek pengandar ini telah didaftarkan pada pemberitahuan ini.

Keterangan

IoRegisterFsRegistrationChangeMountAware mendaftarkan driver filter sistem file untuk diberi tahu setiap kali sistem file memanggil IoRegisterFileSystem atau IoUnregisterFileSystem.

Untuk berhenti menerima pemberitahuan tersebut, driver filter harus memanggil IoUnregisterFsRegistrationChange.

Ketika SynchronizeWithMounts ditentukan sebagai TRUE, IoRegisterFsRegistrationChangeMountAware menunggu operasi pemasangan saat ini selesai dan tidak memungkinkan operasi pemasangan baru dimulai hingga IoRegisterFsRegistrationChangeMountAware selesai.

Catatan Ketika driver filter sistem file memanggil IoRegisterFsRegistrationChangeMountAware, rutinitas pemberitahuannya juga dipanggil segera untuk semua sistem file yang saat ini terdaftar, Yaitu, sistem file yang telah disebut IoRegisterFileSystem, tetapi belum memanggil IoUnregisterFileSystem.

Karena rutinitas pemberitahuan penelepon dapat dipanggil bahkan sebelum IoRegisterFsRegistrationChangeMountAware kembali, driver filter tidak boleh memanggil rutinitas ini sampai setelah membuat struktur data yang diperlukan untuk memproses pemberitahuan ini.

Selain itu, IoRegisterFsRegistrationChangeMountAware mengabaikan perangkat RAW. Untuk informasi tentang cara melampirkan ke sistem file RAW berdasarkan nama, lihat Melampirkan Objek Perangkat Filter ke Objek Perangkat Target.

IoRegisterFsRegistrationChangeMountAware meningkatkan jumlah referensi pada objek driver driver filter.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Rutinitas IoRegisterFsRegistrationChangeMountAware adalah Windows 7
Target Platform	Universal
Header	ntifs.h (termasuk FltKernel.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL