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)

Lihat juga

IRP

IoGetDeviceToVerify

IoVerifyVolume

PsGetCurrentThread