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

Статья
02/29/2024

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	Том изменился.

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

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

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

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

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

См. также раздел

IoGetDeviceToVerify

IoSetDeviceToVerify

Share via