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 会向设备发送卷装载请求。

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