Функция 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.

Требования

См. также

IoGetDeviceObjectPointer