Функция IoGetRelatedDeviceObject (wdm.h)

При наличии объекта файла подпрограмма IoGetRelatedDeviceObject возвращает указатель на соответствующий объект устройства.

Синтаксис

PDEVICE_OBJECT IoGetRelatedDeviceObject(
  [in] PFILE_OBJECT FileObject
);

Параметры

[in] FileObject

Указатель на объект файла.

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

IoGetRelatedDeviceObject возвращает указатель на объект устройства.

Комментарии

При вызове для объекта файла, представляющего базовое запоминающее устройство, IoGetRelatedDeviceObject возвращает объект устройства самого высокого уровня в стеке устройств хранения. Чтобы получить объект устройства самого высокого уровня в стеке драйверов файловой системы, драйверы должны вызвать IoGetRelatedDeviceObject в объекте файла, который представляет стек драйверов файловой системы, и файловая система должна быть подключена в данный момент. (В противном случае выполняется обход стека запоминающего устройства, а не стека файловой системы.)

Чтобы обеспечить подключение файловой системы на запоминающее устройство, драйвер должен указать соответствующую маску доступа, например FILE_READ_DATA или FILE_WRITE_ATTRIBUTES, при открытии файла или устройства, представленного объектом файла. Указание FILE_READ_ATTRIBUTES не приводит к подключению файловой системы.

Вызывающий объект должен выполняться в среде IRQL <= DISPATCH_LEVEL. Как правило, вызывающие эту подпрограмму выполняются в irQL = PASSIVE_LEVEL.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 2000.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (см. раздел "Примечания")

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

IoGetDeviceObjectPointer