Fungsi IoSetHardErrorOrVerifyDevice (ntddk.h)
Driver tingkat bawah memanggil rutinitas IoSetHardErrorOrVerifyDevice untuk mengidentifikasi perangkat media yang dapat dilepas yang mengalami kesalahan, sehingga driver sistem file dapat meminta pengguna untuk memverifikasi bahwa media tersebut valid.
Sintaks
void IoSetHardErrorOrVerifyDevice(
[in] PIRP Irp,
[in] PDEVICE_OBJECT DeviceObject
);
Parameter
[in] Irp
Penunjuk ke IRP yang drivernya mengalami kesalahan yang diinduksi pengguna.
[in] DeviceObject
Arahkan ke perangkat target yang akan diverifikasi untuk operasi I/O.
Nilai kembali
Tidak ada
Keterangan
Driver tingkat bawah untuk perangkat media penghapusan harus memanggil IoSetHardErrorOrVerifyDevice sebelum menyelesaikan IRP, jika panggilan ke IoIsErrorUserInduced mengembalikan TRUE. Untuk informasi selengkapnya, lihat Mendukung Media yang Dapat Dilepas.
Selanjutnya, driver sistem file akan menggunakan informasi yang disediakan dalam objek perangkat yang ditentukan untuk mengirim kotak dialog kepada pengguna, yang dapat memperbaiki kesalahan dan mencoba kembali operasi atau membatalkannya.
IRP yang diteruskan ke IoSetHardErrorOrVerifyDevice harus dikaitkan dengan utas. Oleh karena itu, sebelum driver memanggil IoSetHardErrorOrVerifyDevice, driver harus memverifikasi bahwa irp-Tail.Overlay>. Utas bukan NULL. Jika nilainya adalah NULL, IoSetHardErrorOrVerifyDevice tidak boleh dipanggil menggunakan IRP saat ini. Sebagai gantinya, driver harus memeriksa semua runtime integrasi yang kemudian diterima dan diproses, sampai satu diterima di mana irp-Tail.Overlay>. Utas bukan NULL. Pada saat itu, IoSetHardErrorOrVerifyDevice dapat dipanggil.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows 2000. |
Target Platform | Universal |
Header | ntddk.h (termasuk Ntddk.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <=DISPATCH_LEVEL |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk