IoVerifyVolume-Funktion (ntifs.h)

Die IoVerifyVolume-Routine sendet eine Volumeüberprüfungsanforderung an das angegebene Wechselmediengerät.

Syntax

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

Parameter

[in] DeviceObject

Zeiger auf das Geräteobjekt für das Gerät, auf dem das Volume überprüft werden soll.

[in] AllowRawMount

Legen Sie auf TRUE fest, wenn diese Überprüfungsanforderung im Namen einer geöffneten DASD-Anforderung ausgestellt wird, und eine unformatierte Bereitstellung sollte ausgeführt werden, wenn die Überprüfungsanforderung fehlschlägt.

Rückgabewert

IoVerifyVolume kann einen der folgenden NTSTATUS-Werte zurückgeben:

Rückgabecode Beschreibung
STATUS_SUCCESS
STATUS_INSUFFICIENT_RESOURCES
STATUS_UNSUCCESSFUL
STATUS_WRONG_VOLUME

Bemerkungen

IoVerifyVolume sendet eine Volumeüberprüfungsanforderung an das angegebene Wechselmediengerät.

Wenn der Überprüfungsvorgang fehlschlägt, sendet der I/O-Manager eine Volume-Mount-Anforderung an das Gerät.

Vor der Verwendung von IoSetDeviceToVerify und IoVerifyVolume werden Treiberautoren dringend empfohlen, die Art und Weise zu untersuchen, wie diese Routinen im FASTFAT-Beispiel verwendet werden.

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

Anforderungen

   
Zielplattform Universell
Header ntifs.h (einschließlich Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Weitere Informationen

IoGetDeviceToVerify

IoSetDeviceToVerify