IoVerifyVolume-Funktion (ntifs.h)

IoVerifyVolume sendet eine Volumeüberprüfungsanforderung an das vom Geräteobjekt identifizierte angegebene Wechselmediengerät.

Syntax

NTSTATUS IoVerifyVolume(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] BOOLEAN        AllowRawMount
);

Parameter

[in] DeviceObject

Zeigen Sie 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

Ein Wert von TRUE gibt an, dass diese Überprüfungsanforderung im Auftrag einer geöffneten DASD-Anforderung (Direct Access Storage Device) ausgestellt wird, was angibt, dass eine unformatierte Bereitstellung ausgeführt werden soll, wenn die Überprüfungsanforderung fehlschlägt.

Rückgabewert

IoVerifyVolume den NTSTATUS-Code aus dem Überprüfungsvorgang zurück, der möglicherweise einer der folgenden Werte ist:

Rückgabecode	Beschreibung
STATUS_SUCCESS	IoVerifyVolume festgestellt, dass sich das Volume nicht geändert hat oder zuvor nicht bereitgestellt wurde.
STATUS_INSUFFICIENT_RESOURCES	Es sind nicht genügend Systemressourcen vorhanden, um den Vorgang abzuschließen.
STATUS_UNSUCCESSFUL	Der Überprüfungsvorgang war nicht erfolgreich.
STATUS_WRONG_VOLUME	Das Volume wurde geändert.

Bemerkungen

Bevor Sie IoSetDeviceToVerify und IoVerifyVolumeverwenden, sollten Treiberautoren untersuchen, wie diese Routinen im FASTFAT-Beispielverwendet werden.

IoVerifyVolume wird aufgerufen, um ein bereitgestelltes Volume auf dem angegebenen Gerät zu überprüfen, wenn es scheint, 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 bereitgestelltes 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 Volume-Mount-Anforderung an das Gerät.

Weitere Informationen zu Wechselmediengeräten finden Sie unter Unterstützen von Wechselmedien.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	< DISPATCH_LEVEL

Siehe auch

IoGetDeviceToVerify

IoSetDeviceToVerify