Fungsi IoSetHardErrorOrVerifyDevice (ntddk.h)

  • Artikel

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

IoIsErrorUserInduced

IoRaiseHardError

IoRaiseInformationalHardError