IoVerifyVolume 函数 (ntifs.h)

IoVerifyVolume 向设备对象标识的指定可移动媒体设备发送卷验证请求。

语法

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

参数

[in] DeviceObject

指向 DEVICE_OBJECT 结构的指针,该结构标识要验证/装载卷的设备的设备对象。

[in] AllowRawMount

TRUE 值表示此验证请求是代表 DASD(直接访问存储设备)打开请求颁发的,这表示在验证请求失败时应执行原始装载。

返回值

IoVerifyVolume 从验证作中返回 NTSTATUS 代码,这可能是以下值之一:

返回代码 描述
STATUS_SUCCESS IoVerifyVolume 确定卷未更改或以前未装载。
STATUS_INSUFFICIENT_RESOURCES 系统资源不足,无法完成作。
STATUS_UNSUCCESSFUL 验证作失败。
STATUS_WRONG_VOLUME 卷已更改。

言论

在使用 IoSetDeviceToVerifyIoVerifyVolume之前,驱动程序编写器应研究在 FASTFAT 示例中使用的这些例程的方式。

IoVerifyVolume 被调用,以检查指定设备上装载的卷时,该卷似乎自上次访问以来可能已更改。 文件系统驱动程序通常在较低设备返回STATUS_VERIFY_REQUIRED时调用 IoSetDeviceToVerifyIoVerifyVolume

如果 DeviceObject 已装载卷,IoVerifyVolume 检查卷是否已更改。

如果卷已更改或以前未装载,IoVerifyVolume 向设备发送卷装载请求。

有关可移动媒体设备的详细信息,请参阅 支持可移动媒体

要求

要求 价值
目标平台 普遍
标头 ntifs.h (include Ntifs.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

另请参阅

IoGetDeviceToVerify

IoSetDeviceToVerify