IoSetDeviceToVerify-Funktion (ntifs.h)
Die IoSetDeviceToVerify Routine legt fest, dass das Geräteobjekt im angegebenen Thread überprüft wird. Das angegebene Geräteobjekt stellt ein Wechselmediengerät dar.
Syntax
void IoSetDeviceToVerify(
[in] PETHREAD Thread,
[in, optional] PDEVICE_OBJECT DeviceObject
);
Parameter
[in] Thread
Zeigen Sie auf eine ETHREAD Threadobjektstruktur für den Thread.
[in, optional] DeviceObject
Zeigen Sie auf eine DEVICE_OBJECT-Struktur, die das Geräteobjekt für ein Wechselmediengerät identifiziert. DeviceObject- kann NULL sein.
Rückgabewert
Nichts
Bemerkungen
Bevor Sie IoSetDeviceToVerify und IoVerifyVolume-verwenden, sollten Treiberautoren untersuchen, wie diese Routinen im FASTFAT-Beispiel verwendet werden. Weitere Informationen finden Sie auch unter Unterstützen von Wechselmedien.
IoSetDeviceToVerify wird aufgerufen, um anzugeben, dass ein bestimmtes Geräteobjekt, das ein Wechselmediengerät darstellt, überprüft werden muss. Rufen Sie IoGetDeviceToVerify auf, um das Geräteobjekt abzurufen, das das Ziel der E/A-Anforderung des angegebenen Threads ist.
Ein Dateisystemtreiber muss ein Volume überprüfen, wenn es eine Benachrichtigung von einem zugrunde liegenden Wechselmediengerätetreiber empfängt, dass sich das Medium seit dem letzten Zugriff auf das Zielgerät geändert hat. Das Dateisystem ruft in der Regel IoSetDeviceToVerify und IoVerifyVolume- auf, wenn das untere Gerät STATUS_VERIFY_REQUIRED zurückgibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | IrqlIoDispatch(wdm) |