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 (include Ntifs.h) |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |