IoVerifyVolume-Funktion (ntifs.h)

  • Artikel

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

Weitere Informationen

IoGetDeviceToVerify

IoSetDeviceToVerify