Fungsi IoVerifyVolume (ntifs.h)
IoVerifyVolume mengirimkan permintaan verifikasi volume ke perangkat media yang dapat dilepas yang ditentukan yang diidentifikasi oleh objek perangkat.
Sintaks
NTSTATUS IoVerifyVolume(
[in] PDEVICE_OBJECT DeviceObject,
[in] BOOLEAN AllowRawMount
);
Parameter
[in] DeviceObject
Arahkan ke struktur DEVICE_OBJECT yang mengidentifikasi objek perangkat untuk perangkat tempat volume akan diverifikasi/dipasang.
[in] AllowRawMount
Nilai TRUE menunjukkan bahwa permintaan verifikasi ini dikeluarkan atas nama permintaan terbuka DASD (perangkat penyimpanan akses langsung), yang menunjukkan bahwa pemasangan mentah harus dilakukan jika permintaan verifikasi gagal.
Nilai kembali
IoVerifyVolume mengembalikan kode NTSTATUS dari operasi verifikasi, yang mungkin merupakan salah satu nilai berikut:
| Menampilkan kode | Deskripsi |
|---|---|
| STATUS_SUCCESS | IoVerifyVolume menentukan bahwa volume tidak berubah atau sebelumnya tidak dipasang. |
| STATUS_INSUFFICIENT_RESOURCES | Sumber daya sistem tidak cukup ada untuk menyelesaikan operasi. |
| STATUS_UNSUCCESSFUL | Operasi verifikasi tidak berhasil. |
| STATUS_WRONG_VOLUME | Volume telah berubah. |
Keterangan
Sebelum menggunakan IoSetDeviceToVerify dan IoVerifyVolume, penulis driver harus mempelajari cara rutinitas ini digunakan dalam sampel FASTFAT.
IoVerifyVolume dipanggil untuk memeriksa volume yang dipasang pada perangkat yang ditentukan ketika tampaknya volume mungkin telah berubah sejak terakhir kali diakses. Driver sistem file biasanya memanggil IoSetDeviceToVerify dan IoVerifyVolume ketika perangkat yang lebih rendah kembali STATUS_VERIFY_REQUIRED.
Jika DeviceObject memiliki volume yang dipasang, IoVerifyVolume memeriksa apakah volume telah berubah.
Jika volume telah berubah atau belum dipasang sebelumnya, IoVerifyVolume mengirimkan permintaan pemasangan volume ke perangkat.
Untuk informasi selengkapnya tentang perangkat media yang dapat dilepas, lihat Mendukung Media yang Dapat Dilepas.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | ntifs.h (termasuk Ntifs.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |