IoVerifyVolume-Funktion (ntifs.h)
IoVerifyVolume sendet eine Volumeüberprüfungsanforderung an das angegebene Wechselmediengerät, das durch das Geräteobjekt identifiziert wird.
Syntax
NTSTATUS IoVerifyVolume(
[in] PDEVICE_OBJECT DeviceObject,
[in] BOOLEAN AllowRawMount
);
Parameter
[in] DeviceObject
Zeiger auf eine DEVICE_OBJECT Struktur, die das Geräteobjekt für das Gerät identifiziert, auf dem das Volume überprüft/eingebunden werden soll.
[in] AllowRawMount
Der Wert TRUE gibt an, dass diese Überprüfungsanforderung im Namen einer offenen DASD-Anforderung (Direct-Access Storage Device) ausgestellt wird, was angibt, dass eine rohe Bereitstellung durchgeführt werden soll, wenn die Überprüfungsanforderung fehlschlägt.
Rückgabewert
IoVerifyVolume gibt den NTSTATUS-Code aus dem Überprüfungsvorgang zurück, bei dem es sich um einen der folgenden Werte handeln kann:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | IoVerifyVolume hat ermittelt, dass sich das Volume nicht geändert hat oder zuvor nicht eingebunden wurde. |
| STATUS_INSUFFICIENT_RESOURCES | Es sind unzureichende Systemressourcen vorhanden, um den Vorgang abzuschließen. |
| STATUS_UNSUCCESSFUL | Der Überprüfungsvorgang war nicht erfolgreich. |
| STATUS_WRONG_VOLUME | Das Volume hat sich geändert. |
Hinweise
Vor der Verwendung von IoSetDeviceToVerify und IoVerifyVolume sollten Treiberautoren untersuchen, wie diese Routinen im FASTFAT-Beispiel verwendet werden.
IoVerifyVolume wird aufgerufen, um ein bereitgestelltes Volume auf dem angegebenen Gerät zu überprüfen, wenn es den Anschein hat, dass sich das Volume seit dem letzten Zugriff geändert hat. Ein Dateisystemtreiber ruft in der Regel IoSetDeviceToVerify und IoVerifyVolume auf , wenn das untere Gerät STATUS_VERIFY_REQUIRED zurückgibt.
Wenn das DeviceObject über ein eingebundenes Volume verfügt, überprüft IoVerifyVolume , ob sich das Volume geändert hat.
Wenn sich das Volume geändert hat oder noch nicht bereitgestellt wurde, sendet IoVerifyVolume eine Volumebereitstellungsanforderung an das Gerät.
Weitere Informationen zu Wechselmediengeräten finden Sie unter Unterstützen von Wechselmedien.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ntifs.h (include Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |