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

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

Синтаксис

VOID IoRegisterFileSystem(
  [in] __drv_aliasesMem PDEVICE_OBJECT DeviceObject
);

Параметры

[in] DeviceObject

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

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

Никакой

Замечания

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.

Требования

См. также

IoRegisterFsRegistrationChange

IoRegisterFsRegistrationChangeEx

IoUnregisterFileSystem

IoUnregisterFsRegistrationChange