Fonction IoRegisterFsRegistrationChangeEx (ntifs.h)

  • Article

La routine IoRegisterFsRegistrationChangeEx enregistre la routine de notification d’un pilote de filtre de système de fichiers à appeler chaque fois qu’un système de fichiers s’inscrit ou se désinscrit en tant que système de fichiers actif.

Syntaxe

NTSTATUS IoRegisterFsRegistrationChangeEx(
  [in] PDRIVER_OBJECT          DriverObject,
  [in] PDRIVER_FS_NOTIFICATION DriverNotificationRoutine
);

Paramètres

[in] DriverObject

Pointeur vers l’objet pilote 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 lui-même.

Valeur retournée

IoRegisterFsRegistrationChangeEx retourne l’une des valeurs 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.

Remarques

L’effet de IoRegisterFsRegistrationChangeEx est identique à celui d’IoRegisterFsRegistrationChange sur Windows XP et versions ultérieures.

IoRegisterFsRegistrationChangeEx inscrit un pilote de filtre de système de fichiers à notifier chaque fois qu’un système de fichiers appelle IoRegisterFileSystem ou IoUnregisterFileSystem.

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

Lorsqu’un pilote de filtre de système de fichiers appelle IoRegisterFsRegistrationChangeEx, sa routine de notification est également appelée immédiatement pour tous les systèmes de fichiers actuellement inscrits (autrement dit, 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 le retour de IoRegisterFsRegistrationChangeEx , 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.

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

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

Si un pilote de filtre de système de fichiers appelle IoRegisterFsRegistrationChangeEx deux fois de suite (sans appeler IoUnregisterFsRegistrationChange entre les deux), passant les mêmes valeurs pour les paramètres DriverObject et DriverNotificationRoutine qu’il a inscrits lors de l’appel précédent à IoRegisterFsRegistrationChangeEx, et aucun autre pilote de filtre n’a été inscrit depuis le premier appel, IoRegisterFsRegistrationChangeEx retourne STATUS_DEVICE_ALREADY_ATTACHED.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Cette routine est disponible uniquement sur le correctif cumulatif pour le système d’exploitation Windows 2000 Service Pack 4 (SP4).
Plateforme cible Desktop (Expérience utilisateur)
En-tête ntifs.h (inclure Ntifs.h)
IRQL <= APC_LEVEL

Voir aussi

IoRegisterFileSystem

IoRegisterFsRegistrationChange

IoUnregisterFileSystem

IoUnregisterFsRegistrationChange