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

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

Синтаксис

PDEVICE_OBJECT IoGetDeviceToVerify(
  [in] PETHREAD Thread
);

Параметры

[in] Thread

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

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

IoGetDeviceToVerify возвращает указатель на структуру DEVICE_OBJECT, которая идентифицирует объект устройства, представляющего устройство, на котором следует проверить носитель. Эта функция может возвращать ЗНАЧЕНИЕ NULL.

Замечания

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000
целевая платформа Всеобщий
заголовка ntifs.h (include Ntifs.h)
библиотеки NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
правил соответствия DDI HwStorPortProhibitedDIs(storport), IrqlIoDispatch(wdm), PowerIrpDDis(wdm)

См. также

IoIsErrorUserInduced

IoSetDeviceToVerify

IoSetHardErrorOrVerifyDevice

PsGetCurrentThread