Fungsi IoGetDeviceToVerify (ntifs.h)

Rutinitas IoGetDeviceToVerify mengembalikan pointer ke objek perangkat, mewakili perangkat media yang dapat dilepas, yang merupakan target permintaan I/O utas yang diberikan.

Sintaks

PDEVICE_OBJECT IoGetDeviceToVerify(
  [in] PETHREAD Thread
);

Parameter

[in] Thread

Penunjuk ke struktur ETHREAD yang objek perangkatnya sedang dikueri. Artinya, Thread adalah utas yang driver tingkat tertingginya mencoba memverifikasi validitas media tempat utas telah membuka file.

Nilai kembali

IoGetDeviceToVerify mengembalikan pointer ke struktur DEVICE_OBJECT yang mengidentifikasi objek perangkat yang mewakili perangkat tempat media harus diverifikasi. Fungsi ini dapat mengembalikan NULL.

Keterangan

Secara umum, driver tingkat tertinggi, terutama sistem file, kemungkinan besar akan memanggil rutinitas ini.

Driver perangkat media yang dapat dilepas yang mendasar bertanggung jawab untuk memberi tahu driver tingkat yang lebih tinggi, terutama sistem file, ketika media tampaknya telah berubah sejak akses terakhir ke perangkat target. Untuk informasi selengkapnya, lihat Memberi tahu Sistem File tentang Kemungkinan Perubahan Media.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), IrqlIoDispatch(wdm), PowerIrpDDis(wdm)

Lihat juga

IoIsErrorUserInduced

IoSetDeviceToVerify

IoSetHardErrorOrVerifyDevice

PsGetCurrentThread