IoSetDeviceToVerify-Funktion (ntifs.h)
Die IoSetDeviceToVerify-Routine legt das Geräteobjekt fest, das im angegebenen Thread überprüft werden soll. Das angegebene Geräteobjekt stellt ein Wechselmedium dar.
Syntax
void IoSetDeviceToVerify(
[in] PETHREAD Thread,
[in, optional] PDEVICE_OBJECT DeviceObject
);
Parameter
[in] Thread
Zeiger auf eine ETHREAD-Threadobjektstruktur für den Thread.
[in, optional] DeviceObject
Zeiger auf eine DEVICE_OBJECT-Struktur , die das Geräteobjekt für ein Wechselmediengerät identifiziert. DeviceObject kann NULL sein.
Rückgabewert
Keine
Bemerkungen
Vor der Verwendung von IoSetDeviceToVerify und IoVerifyVolume sollten Treiberautoren untersuchen, wie diese Routinen im FASTFAT-Beispiel verwendet werden. Weitere Informationen finden Sie unter Unterstützung von Wechselmedien.
IoSetDeviceToVerify wird aufgerufen, um anzugeben, dass ein bestimmtes Geräteobjekt, das ein Wechselmedium 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 die Medien seit dem letzten Zugriff auf das Zielgerät anscheinend geändert haben. Das Dateisystem ruft in der Regel IoSetDeviceToVerify und IoVerifyVolume auf , wenn das untere Gerät STATUS_VERIFY_REQUIRED zurückgibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ntifs.h (include Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | IrqlIoDispatch(wdm) |