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

  • Статья

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

Синтаксис

void IoRegisterFileSystem(
  [in] __drv_aliasesMem PDEVICE_OBJECT DeviceObject
);

Параметры

[in] DeviceObject

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

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

None

Remarks

IoRegisterFileSystem регистрирует файловую систему в качестве активной файловой системы, вставляя объект устройства управления файловой системы в очередь глобальной файловой системы и увеличивает количество ссылок на объект устройства управления файловой системы.

Тип устройства объекта управления файловой системой должен иметь один из следующих типов:

FILE_DEVICE_NETWORK_FILE_SYSTEM

FILE_DEVICE_CD_ROM_FILE_SYSTEM

FILE_DEVICE_DISK_FILE_SYSTEM

Если тип устройства не является одним из этих значений, файловая система не регистрируется.

Кроме того, необходимо указать имя объекта устройства управления файловой системой. Если имя не задано, это не приведет к сбою вызова IoRegisterFileSystem . Однако драйверы фильтров файловой системы, а также многие системные компоненты и подпрограммы поддержки используют это имя, чтобы отличать объекты управляющих устройств файловой системы, которые всегда называются, от объектов устройства тома, которые никогда не называются.

Если флаг DO_LOW_PRIORITY_FILESYSTEM установлен в объекте управляющего устройства файловой системы, объект устройства вставляется в следующую позицию в очереди. (Файловая система RAW занимает последнее место в очереди.) Если этот флаг не установлен, объект устройства вставляется в начало очереди.

IoRegisterFileSystem вызывает подпрограммы уведомлений драйверов фильтров файловой системы, зарегистрированных для этого уведомления, путем вызова IoRegisterFsRegistrationChange или IoRegisterFsRegistrationChangeEx.

Примечание В Microsoft Windows XP и более поздних версиях, когда драйвер фильтра файловой системы вызывает IoRegisterFsRegistrationChange, его подпрограмма уведомлений также вызывается немедленно для всех файловых систем, которые уже вызвали IoRegisterFileSystem.
 

Требования

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

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

IoRegisterFsRegistrationChange

IoRegisterFsRegistrationChangeEx

IoUnregisterFileSystem

IoUnregisterFsRegistrationChange