Fungsi FsRtlNotifyVolumeEvent (ntifs.h)
FsRtlNotifyVolumeEvent rutin memberi tahu aplikasi terdaftar bahwa peristiwa volume sedang terjadi.
Sintaks
NTSTATUS FsRtlNotifyVolumeEvent(
[in] PFILE_OBJECT FileObject,
[in] ULONG EventCode
);
Parameter
[in] FileObject
Penunjuk ke objek file untuk volume yang diberikan.
[in] EventCode
Menentukan kode peristiwa untuk peristiwa yang sedang terjadi. Kode ini bisa menjadi salah satu nilai berikut.
| Kode Peristiwa | GUID peristiwa PnP | Makna |
|---|---|---|
| FSRTL_VOLUME_BACKGROUND_FORMAT | GUID_IO_VOLUME_BACKGROUND_FORMAT | Operasi format latar belakang telah dimulai. |
| FSRTL_VOLUME_CHANGE_SIZE | GUID_IO_VOLUME_CHANGE_SIZE | Ukuran sistem file pada volume telah berubah. Untuk Windows Server 2003 dan Windows XP/2000, nilai ini tidak didukung. |
| FSRTL_VOLUME_DISMOUNT | GUID_IO_VOLUME_DISMOUNT | Volume sedang dilepas. |
| FSRTL_VOLUME_DISMOUNT_FAILED | GUID_IO_VOLUME_DISMOUNT_FAILED | Pembuangan volume gagal. |
| FSRTL_VOLUME_FORCED_CLOSED | GUID_IO_VOLUME_FORCE_CLOSED | Volume telah dibuat baca-saja oleh sistem file. Bendera ini tersedia di Windows Vista dan yang lebih baru. |
| FSRTL_VOLUME_INFO_MAKE_COMPAT | GUID_IO_VOLUME_INFO_MAKE_COMPAT | Media volume telah dihapus, tetapi dalam keadaan tidak kompatibel dan mungkin tidak dapat dibaca oleh perangkat penyimpanan media yang dapat dilepas yang berbeda. Bendera ini tersedia di Windows Vista dan yang lebih baru. |
| FSRTL_VOLUME_LOCK | GUID_IO_VOLUME_LOCK | Volume sedang dikunci. |
| FSRTL_VOLUME_LOCK_FAILED | GUID_IO_VOLUME_LOCK_FAILED | Kunci volume gagal. |
| FSRTL_VOLUME_MOUNT | GUID_IO_VOLUME_MOUNT | Volume sedang dipasang. |
| FSRTL_VOLUME_NEEDS_CHKDSK | GUID_IO_VOLUME_NEED_CHKDSK | Kerusakan data terdeteksi pada volume dan perlu diperbaiki dengan menjalankan Chkdsk. Bendera ini tersedia di Windows Vista dan yang lebih baru. |
| FSRTL_VOLUME_PREPARING_EJECT | GUID_IO_VOLUME_PREPARING_EJECT | Sistem file sedang mempersiapkan diska yang akan dikeluarkan. Untuk Windows Server 2003 dan Windows XP/2000, nilai ini tidak didukung. |
| FSRTL_VOLUME_UNLOCK | GUID_IO_VOLUME_UNLOCK | Volume sedang dibuka kuncinya. |
| FSRTL_VOLUME_WEARING_OUT | GUID_IO_VOLUME_WEARING_OUT | Media volume aus. Bendera ini tersedia di Windows Vista dan yang lebih baru. |
| FSRTL_VOLUME_WORM_NEAR_FULL | GUID_IO_VOLUME_WORM_NEAR_FULL | Volumenya adalah volume tulis-sekali, baca-banyak (WORM) dan hampir penuh. Bendera ini tersedia di Windows Vista dan yang lebih baru. |
Mengembalikan nilai
FsRtlNotifyVolumeEvent mengembalikan status pemberitahuan.
Keterangan
Sistem file memanggil FsRtlNotifyVolumeEvent untuk memberi tahu aplikasi mode pengguna terdaftar bahwa peristiwa volume sedang terjadi.
Nilai GUID peristiwa PnP didefinisikan dalam Ioevent.h.
Untuk mendaftar pemberitahuan peristiwa volume, aplikasi harus memanggil fungsi Microsoft Win32 RegisterDeviceNotification . Untuk informasi selengkapnya, lihat bagian Manajemen Perangkat di dokumentasi Microsoft Windows SDK.
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 | <= APC_LEVEL |