Функция IoVerifyVolume (ntifs.h)

Статья
02/07/2025

IoVerifyVolume отправляет запрос проверки тома на указанное устройство с съемным носителем, определяемое объектом устройства.

Синтаксис

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

Параметры

[in] DeviceObject

Указатель на структуру DEVICE_OBJECT, которая определяет объект устройства для устройства, на котором требуется проверить или подключить том.

[in] AllowRawMount

Значение TRUE указывает, что этот запрос проверки выдается от имени открытого запроса DASD (устройства хранения direct-access), который указывает, что необработанное подключение должно выполняться, если запрос проверки завершается ошибкой.

Возвращаемое значение

IoVerifyVolume возвращает код NTSTATUS из операции проверки, которая может быть одним из следующих значений:

Возвращаемый код	Описание
STATUS_SUCCESS	IoVerifyVolume определили, что том не изменился или не был подключен ранее.
STATUS_INSUFFICIENT_RESOURCES	Недостаточно системных ресурсов для завершения операции.
STATUS_UNSUCCESSFUL	Операция проверки была неудачной.
STATUS_WRONG_VOLUME	Том изменился.

Замечания

Перед использованием IoSetDeviceToVerify и IoVerifyVolume, средства записи драйверов должны изучить способ использования этих подпрограмм в примере FASTFAT.

IoVerifyVolume вызывается для проверки подключенного тома на указанном устройстве при появлении изменения тома с момента последнего доступа. Драйвер файловой системы обычно вызывает IoSetDeviceToVerify и IoVerifyVolume, когда нижнее устройство возвращает STATUS_VERIFY_REQUIRED.

Если DeviceObject имеет подключенный том, IoVerifyVolume проверяет, изменился ли том.

Если том изменился или не был подключен, IoVerifyVolume отправляет запрос на подключение тома на устройство.

Дополнительные сведения об съемных носителях см. в поддержке съемных носителей.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

См. также

IoGetDeviceToVerify

IoSetDeviceToVerify

Поделиться через