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 | 卷已更改。 |
注解
在使用 IoSetDeviceToVerify 和 IoVerifyVolume 之前,驱动程序编写器应研究 在 FASTFAT 示例中使用这些例程的方式。
调用 IoVerifyVolume 以检查指定设备上装载的卷时,该卷自上次访问以来可能已更改。 当较低设备返回STATUS_VERIFY_REQUIRED时,文件系统驱动程序通常会调用 IoSetDeviceToVerify 和 IoVerifyVolume 。
如果 DeviceObject 有已装载的卷, IoVerifyVolume 会检查该卷是否已更改。
如果卷已更改或以前尚未装载, IoVerifyVolume 会向设备发送卷装载请求。
有关可移动媒体设备的详细信息,请参阅 支持可移动媒体。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | ntifs.h (包括 Ntifs.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |