Fungsi IoRegisterFileSystem (ntifs.h)

Artikel
02/29/2024

Rutinitas IoRegisterFileSystem menambahkan objek perangkat kontrol sistem file ke antrean sistem file global.

Sintaks

void IoRegisterFileSystem(
  [in] __drv_aliasesMem PDEVICE_OBJECT DeviceObject
);

Parameter

[in] DeviceObject

Arahkan ke objek perangkat kontrol untuk sistem file.

Nilai kembali

Tidak ada

Keterangan

IoRegisterFileSystem mendaftarkan sistem file sebagai sistem file aktif dengan memasukkan objek perangkat kontrol sistem file ke dalam antrean sistem file global, dan meningkatkan jumlah referensi pada objek perangkat kontrol sistem file.

Jenis perangkat objek perangkat kontrol sistem file harus salah satu dari berikut ini:

FILE_DEVICE_NETWORK_FILE_SYSTEM

FILE_DEVICE_CD_ROM_FILE_SYSTEM

FILE_DEVICE_DISK_FILE_SYSTEM

Jika jenis perangkat bukan salah satu nilai ini, sistem file tidak terdaftar.

Selain itu, objek perangkat kontrol sistem file harus diberi nama. Jika tidak diberi nama, ini tidak menyebabkan panggilan ke IoRegisterFileSystem gagal. Namun, driver filter sistem file, serta banyak komponen sistem dan mendukung rutinitas, gunakan nama ini untuk membedakan objek perangkat kontrol sistem file, yang selalu diberi nama, dari objek perangkat volumenya, yang tidak pernah diberi nama.

Jika bendera DO_LOW_PRIORITY_FILESYSTEM diatur pada objek perangkat kontrol sistem file, objek perangkat dimasukkan ke posisi berikutnya ke terakhir dalam antrean. (Sistem file RAW menempati posisi terakhir dalam antrean.) Jika bendera ini tidak diatur, objek perangkat disisipkan di bagian kepala antrean.

IoRegisterFileSystem memanggil rutinitas pemberitahuan driver filter sistem file yang telah mendaftar untuk pemberitahuan ini dengan memanggil IoRegisterFsRegistrationChange atau IoRegisterFsRegistrationChangeEx.

Catatan Di Microsoft Windows XP dan yang lebih baru, ketika driver filter sistem file memanggil IoRegisterFsRegistrationChange, rutinitas pemberitahuannya juga dipanggil segera untuk sistem file apa pun yang telah disebut IoRegisterFileSystem.