Fungsi IoSetDeviceToVerify (ntifs.h)
Rutinitas IoSetDeviceToVerify mengatur objek perangkat yang akan diverifikasi dalam utas yang ditentukan. Objek perangkat yang ditentukan mewakili perangkat media yang dapat dilepas.
Sintaks
void IoSetDeviceToVerify(
[in] PETHREAD Thread,
[in, optional] PDEVICE_OBJECT DeviceObject
);
Parameter
[in] Thread
Penunjuk ke struktur objek utas ETHREAD untuk utas.
[in, optional] DeviceObject
Penunjuk ke struktur DEVICE_OBJECT yang mengidentifikasi objek perangkat untuk perangkat media yang dapat dilepas. DeviceObject bisa NULL.
Nilai kembali
Tidak ada
Keterangan
Sebelum menggunakan IoSetDeviceToVerify dan IoVerifyVolume, penulis driver harus mempelajari cara rutinitas ini digunakan dalam sampel FASTFAT. Untuk informasi tambahan, lihat juga Mendukung Media yang Dapat Dilepas.
IoSetDeviceToVerify dipanggil untuk menunjukkan bahwa objek perangkat tertentu, yang mewakili perangkat media yang dapat dilepas, perlu diverifikasi. Panggil IoGetDeviceToVerify untuk mendapatkan objek perangkat yang merupakan target permintaan I/O utas yang diberikan.
Driver sistem file harus memverifikasi volume ketika menerima pemberitahuan dari driver perangkat media yang dapat dilepas yang mendasar bahwa media tampaknya telah berubah sejak akses terakhir ke perangkat target. Sistem file biasanya memanggil IoSetDeviceToVerify dan IoVerifyVolume saat perangkat yang lebih rendah kembali STATUS_VERIFY_REQUIRED.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | ntifs.h (termasuk Ntifs.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |
Aturan kepatuhan DDI | IrqlIoDispatch(wdm) |