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

Статья
08/07/2023

Подпрограмма IoSetDeviceToVerify задает объект устройства для проверки в указанном потоке. Указанный объект device представляет собой устройство со съемным носителем.

Синтаксис

void IoSetDeviceToVerify(
  [in]           PETHREAD       Thread,
  [in, optional] PDEVICE_OBJECT DeviceObject
);

Параметры

[in] Thread

Указатель на структуру объекта потока ETHREAD для потока.

[in, optional] DeviceObject

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

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

None

Remarks

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

IoSetDeviceToVerify вызывается, чтобы указать, что данный объект устройства, представляющий устройство со съемным носителем, должен быть проверен. Вызовите IoGetDeviceToVerify , чтобы получить объект устройства, который является целевым объектом запроса ввода-вывода данного потока.

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

Требования

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

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

IRP

IoGetDeviceToVerify

IoVerifyVolume

PsGetCurrentThread

Share via