Función IoRegisterFileSystem (ntifs.h)

Artículo
02/26/2024

La rutina IoRegisterFileSystem agrega el objeto de dispositivo de control de un sistema de archivos a la cola global del sistema de archivos.

Sintaxis

void IoRegisterFileSystem(
  [in] __drv_aliasesMem PDEVICE_OBJECT DeviceObject
);

Parámetros

[in] DeviceObject

Puntero al objeto de dispositivo de control para el sistema de archivos.

Valor devuelto

None

Observaciones

IoRegisterFileSystem registra un sistema de archivos como un sistema de archivos activo insertando el objeto de dispositivo de control del sistema de archivos en la cola global del sistema de archivos e incrementa el recuento de referencias en el objeto de dispositivo de control del sistema de archivos.

El tipo de dispositivo del objeto de dispositivo de control del sistema de archivos debe ser uno de los siguientes:

FILE_DEVICE_NETWORK_FILE_SYSTEM

FILE_DEVICE_CD_ROM_FILE_SYSTEM

FILE_DEVICE_DISK_FILE_SYSTEM

Si el tipo de dispositivo no es uno de estos valores, el sistema de archivos no se registra.

Además, el objeto de dispositivo de control del sistema de archivos debe tener el nombre . Si no se llama, esto no hace que se produzca un error en la llamada a IoRegisterFileSystem . Sin embargo, los controladores de filtro del sistema de archivos, así como muchos componentes del sistema y rutinas de soporte técnico, usan este nombre para distinguir los objetos de dispositivo de control del sistema de archivos, que siempre se denominan, de sus objetos de dispositivo de volumen, que nunca se denominan.

Si la marca DO_LOW_PRIORITY_FILESYSTEM se establece en el objeto de dispositivo de control del sistema de archivos, el objeto de dispositivo se inserta en la posición siguiente a última de la cola. (El sistema de archivos RAW ocupa la última posición de la cola). Si no se establece esta marca, el objeto de dispositivo se inserta en el encabezado de la cola.

IoRegisterFileSystem llama a las rutinas de notificación de los controladores de filtro del sistema de archivos que se han registrado para esta notificación mediante una llamada a IoRegisterFsRegistrationChange o IoRegisterFsRegistrationChangeEx.

Nota En Microsoft Windows XP y versiones posteriores, cuando un controlador de filtro del sistema de archivos llama a IoRegisterFsRegistrationChange, también se llama inmediatamente a su rutina de notificación para cualquier sistema de archivos que ya se haya llamado IoRegisterFileSystem.