Fonction IoRegisterFsRegistrationChangeMountAware (ntifs.h)

Article
03/08/2023

La routine IoRegisterFsRegistrationChangeMountAware enregistre la routine de notification d’un pilote de filtre de système de fichiers. Cette routine de notification est appelée chaque fois qu’un système de fichiers s’inscrit ou se désinscrit lui-même en tant que système de fichiers actif.

Syntaxe

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

Paramètres

[in] DriverObject

Pointeur vers l’objet driver pour le pilote de filtre du système de fichiers.

[in] DriverNotificationRoutine

Pointeur vers la routine PDRIVER_FS_NOTIFICATION que le système de fichiers appelle lorsqu’il s’inscrit ou se désinscrit.

[in] SynchronizeWithMounts

Si elle est définie sur TRUE, cette routine garantit qu’aucune opération de montage n’est en cours lors de l’exécution de rappels de notification. Si la valeur est FALSE, la routine ne tente pas d’éviter les conflits avec les opérations de montage.

Valeur retournée

Retourne l’une des valeurs NTSTATUS suivantes :

Code de retour	Description
STATUS_SUCCESS	La routine de notification a été correctement inscrite.
STATUS_INSUFFICIENT_RESOURCES	Impossible d’allouer un paquet de notification pour la routine de notification.
STATUS_DEVICE_ALREADY_ATTACHED	Cet objet de pilote a déjà été inscrit avec cette notification.

Remarques

IoRegisterFsRegistrationChangeMountAware inscrit un pilote de filtre de système de fichiers pour être averti chaque fois qu’un système de fichiers appelle IoRegisterFileSystem ou IoUnregisterFileSystem.

Pour arrêter de recevoir ces notifications, le pilote de filtre doit appeler IoUnregisterFsRegistrationChange.

Lorsque SynchronizeWithMounts est spécifié sur TRUE, IoRegisterFsRegistrationChangeMountAware attend que les opérations de montage en cours se terminent et n’autorise pas les nouvelles opérations de montage à commencer tant que IoRegisterFsRegistrationChangeMountAware n’est pas terminé.

Note Lorsqu’un pilote de filtre de système de fichiers appelle IoRegisterFsRegistrationChangeMountAware, sa routine de notification est également appelée immédiatement pour tous les systèmes de fichiers actuellement inscrits, c’est-à-dire les systèmes de fichiers qui ont déjà appelé IoRegisterFileSystem, mais qui n’ont pas encore appelé IoUnregisterFileSystem.

Étant donné que la routine de notification de l’appelant peut être appelée avant même que IoRegisterFsRegistrationChangeMountAware ne retourne, un pilote de filtre ne doit pas appeler cette routine tant qu’il n’a pas créé les structures de données dont il a besoin pour traiter ces notifications.

En outre, IoRegisterFsRegistrationChangeMountAware ignore les appareils RAW. Pour plus d’informations sur l’attachement au système de fichiers RAW par nom, consultez Attachement de l’objet d’appareil de filtre à l’objet d’appareil cible.

IoRegisterFsRegistrationChangeMountAware incrémente le nombre de références sur l’objet pilote du pilote de filtre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	La routine IoRegisterFsRegistrationChangeMountAware est Windows 7
Plateforme cible	Universal
En-tête	ntifs.h (include FltKernel.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

Voir aussi

IoRegisterFileSystem

IoRegisterFsRegistrationChange

IoRegisterFsRegistrationChangeEx

IoUnregisterFileSystem

IoUnregisterFsRegistrationChange

Partager via