The IoRegisterFsRegistrationChangeMountAware routine registers a file system filter driver's notification routine. This notification routine is called whenever a file system registers or unregisters itself as an active file system.
NTKERNELAPI NTSTATUS IoRegisterFsRegistrationChangeMountAware( PDRIVER_OBJECT DriverObject, PDRIVER_FS_NOTIFICATION DriverNotificationRoutine, BOOLEAN SynchronizeWithMounts );
A pointer to the driver object for the file system filter driver.
A pointer to the PDRIVER_FS_NOTIFICATION routine, which the file system calls when it registers or unregisters itself.
If set to TRUE, this routine ensures no mount operations are in progress when making notification callbacks. If set to FALSE, the routine does not attempt to avoid conflicts with mount operations.
Returns one of the following NTSTATUS values:
||The notification routine was successfully registered.|
||A notification packet could not be allocated for the notification routine.|
||This driver object has already been registered with this notification.|
To stop receiving such notifications, the filter driver should call IoUnregisterFsRegistrationChange.
When SynchronizeWithMounts is specified as TRUE, IoRegisterFsRegistrationChangeMountAware waits for any current mount operations to complete and does not allow new mount operations to begin until IoRegisterFsRegistrationChangeMountAware is finished.
Because the caller's notification routine can be called even before IoRegisterFsRegistrationChangeMountAware returns, a filter driver should not call this routine until after it has created data structures it needs to process these notifications.
Additionally, IoRegisterFsRegistrationChangeMountAware ignores RAW devices. For information about how to attach to the RAW file system by name, see Attaching the Filter Device Object to the Target Device Object.
|Windows version||The IoRegisterFsRegistrationChangeMountAware routine is available in Windows 7 and later versions of Windows.|
|Header||ntifs.h (include FltKernel.h, Ntifs.h)|