Функция 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 вызывается для проверка подключенного тома на указанном устройстве, когда кажется, что том мог измениться с момента последнего доступа к нему. Драйвер файловой системы обычно вызывает IoSetDeviceToVerify и IoVerifyVolume , когда нижнее устройство возвращает STATUS_VERIFY_REQUIRED.
Если у объекта DeviceObject есть подключенный том, IoVerifyVolume проверяет, изменился ли том.
Если том был изменен или ранее не был подключен, IoVerifyVolume отправляет запрос на подключение тома на устройство.
Дополнительные сведения о съемных носителях см. в разделе Поддержка съемных носителей.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | ntifs.h (включая Ntifs.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |