IoVerifyVolume function

The IoVerifyVolume routine sends a volume verify request to the given removable-media device.

Syntax

NTSTATUS IoVerifyVolume(
  _In_ PDEVICE_OBJECT DeviceObject,
  _In_ BOOLEAN        AllowRawMount
);

Parameters

DeviceObject

Pointer to the device object for the device on which the volume is to be verified.

AllowRawMount

Set to TRUE if this verify request is being issued on behalf of a DASD open request and a raw mount should be performed if the verify request fails.

Return Value

IoVerifyVolume can return one of the following NTSTATUS values:

Return code Description
STATUS_SUCCESS
STATUS_INSUFFICIENT_RESOURCES
STATUS_UNSUCCESSFUL
STATUS_WRONG_VOLUME

Remarks

IoVerifyVolume sends a volume verify request to the given removable-media device.

If the verify operation fails, the I/O Manager sends a volume mount request to the device.

Before using IoSetDeviceToVerify and IoVerifyVolume, driver writers are strongly encouraged to study the way these routines are used in the FASTFAT sample.

For more information about removable-media devices, see Supporting Removable Media.

Requirements

   
Target Platform Universal
Header ntifs.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL "< DISPATCH_LEVEL"

See Also

IoGetDeviceToVerify

IoSetDeviceToVerify

Send comments about this topic to Microsoft