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

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

Синтаксис

PDEVICE_OBJECT IoGetDeviceToVerify(
  [in] PETHREAD Thread
);

Параметры

[in] Thread

Указатель на структуру ETHREAD , к которой запрашивается объект устройства. То есть Поток — это поток, для которого драйвер верхнего уровня пытается проверить допустимость носителя, на котором поток открыл файл.

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

IoGetDeviceToVerify возвращает указатель на структуру DEVICE_OBJECT , которая идентифицирует объект устройства, представляющий устройство, на котором должен быть проверен носитель. Эта функция может возвращать значение NULL.

Комментарии

Как правило, драйверы самого высокого уровня, особенно файловые системы, скорее всего, будут вызывать эту подпрограмму.

Базовый драйвер устройства со съемным носителем отвечает за уведомление драйверов более высокого уровня, особенно файловой системы, когда носитель, как представляется, изменился с момента последнего доступа к целевому устройству. Дополнительные сведения см. в разделе Уведомление файловой системы о возможных изменениях мультимедиа.

Требования

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

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

IoIsErrorUserInduced

IoSetDeviceToVerify

IoSetHardErrorOrVerifyDevice

PsGetCurrentThread