Función IoRegisterFsRegistrationChangeMountAware (ntifs.h)

  • Artículo

La rutina IoRegisterFsRegistrationChangeMountAware registra una rutina de notificación del controlador de filtro del sistema de archivos. Se llama a esta rutina de notificación cada vez que un sistema de archivos se registra o anula el registro como un sistema de archivos activo.

Sintaxis

NTSTATUS IoRegisterFsRegistrationChangeMountAware(
  [in] PDRIVER_OBJECT          DriverObject,
  [in] PDRIVER_FS_NOTIFICATION DriverNotificationRoutine,
  [in] BOOLEAN                 SynchronizeWithMounts
);

Parámetros

[in] DriverObject

Puntero al objeto de controlador para el controlador de filtro del sistema de archivos.

[in] DriverNotificationRoutine

Puntero a la rutina PDRIVER_FS_NOTIFICATION , a la que llama el sistema de archivos cuando se registra o anula su registro.

[in] SynchronizeWithMounts

Si se establece en TRUE, esta rutina garantiza que no haya ninguna operación de montaje en curso al realizar devoluciones de llamada de notificación. Si se establece en FALSE, la rutina no intenta evitar conflictos con las operaciones de montaje.

Valor devuelto

Devuelve uno de los siguientes valores NTSTATUS:

Código devuelto Descripción
STATUS_SUCCESS
 La rutina de notificación se registró correctamente.
STATUS_INSUFFICIENT_RESOURCES
 No se pudo asignar un paquete de notificación para la rutina de notificación.
STATUS_DEVICE_ALREADY_ATTACHED
 Este objeto de controlador ya se ha registrado con esta notificación.

Comentarios

IoRegisterFsRegistrationChangeMountAware registra un controlador de filtro del sistema de archivos para recibir una notificación cada vez que un sistema de archivos llama a IoRegisterFileSystem o IoUnregisterFileSystem.

Para dejar de recibir estas notificaciones, el controlador de filtro debe llamar a IoUnregisterFsRegistrationChange.

Cuando SynchronizeWithMounts se especifica como TRUE, IoRegisterFsRegistrationChangeMountAware espera a que se completen las operaciones de montaje actuales y no permita que se inicien nuevas operaciones de montaje hasta que finalice IoRegisterFsRegistrationChangeMountAware .

Nota Cuando un controlador de filtro del sistema de archivos llama a IoRegisterFsRegistrationChangeMountAware, también se llama inmediatamente a su rutina de notificación para todos los sistemas de archivos que están registrados actualmente, es decir, los sistemas de archivos que ya han llamado IoRegisterFileSystem, pero aún no han llamado IoUnregisterFileSystem.

Dado que se puede llamar a la rutina de notificación del autor de la llamada incluso antes de que se devuelva IoRegisterFsRegistrationChangeMountAware , un controlador de filtro no debe llamar a esta rutina hasta que haya creado estructuras de datos que necesita para procesar estas notificaciones.

Además, IoRegisterFsRegistrationChangeMountAware omite los dispositivos RAW. Para obtener información sobre cómo adjuntar al sistema de archivos RAW por su nombre, vea Adjuntar el objeto de dispositivo de filtro al objeto de dispositivo de destino.

 
IoRegisterFsRegistrationChangeMountAware incrementa el recuento de referencias en el objeto de controlador del controlador de filtro.

Requisitos

Requisito Value
Cliente mínimo compatible La rutina IoRegisterFsRegistrationChangeMountAware es Windows 7
Plataforma de destino Universal
Encabezado ntifs.h (incluya FltKernel.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Consulte también

IoRegisterFileSystem

IoRegisterFsRegistrationChange

IoRegisterFsRegistrationChangeEx

IoUnregisterFileSystem

IoUnregisterFsRegistrationChange