Fonction IoRegisterFileSystem (ntifs.h)

Article
02/29/2024

La routine IoRegisterFileSystem ajoute l’objet d’appareil de contrôle d’un système de fichiers à la file d’attente du système de fichiers global.

Syntaxe

void IoRegisterFileSystem(
  [in] __drv_aliasesMem PDEVICE_OBJECT DeviceObject
);

Paramètres

[in] DeviceObject

Pointeur vers l’objet de périphérique de contrôle pour le système de fichiers.

Valeur de retour

None

Remarques

IoRegisterFileSystem inscrit un système de fichiers en tant que système de fichiers actif en insérant l’objet d’appareil de contrôle du système de fichiers dans la file d’attente du système de fichiers global, puis incrémente le nombre de références sur l’objet d’appareil de contrôle du système de fichiers.

Le type d’appareil de l’objet d’appareil de contrôle de système de fichiers doit être l’un des suivants :

FILE_DEVICE_NETWORK_FILE_SYSTEM

FILE_DEVICE_CD_ROM_FILE_SYSTEM

FILE_DEVICE_DISK_FILE_SYSTEM

Si le type d’appareil n’est pas l’une de ces valeurs, le système de fichiers n’est pas inscrit.

En outre, l’objet d’appareil de contrôle de système de fichiers doit être nommé. S’il n’est pas nommé, cela n’entraîne pas l’échec de l’appel à IoRegisterFileSystem . Toutefois, les pilotes de filtre de système de fichiers, ainsi que de nombreux composants système et routines de prise en charge, utilisent ce nom pour distinguer les objets de périphérique de contrôle du système de fichiers, qui sont toujours nommés, de ses objets de périphérique de volume, qui ne sont jamais nommés.

Si l’indicateur DO_LOW_PRIORITY_FILESYSTEM est défini sur l’objet d’appareil de contrôle du système de fichiers, l’objet d’appareil est inséré dans l’avant-dernier dans la file d’attente. (Le système de fichiers RAW occupe la dernière position dans la file d’attente.) Si cet indicateur n’est pas défini, l’objet d’appareil est inséré en tête de la file d’attente.

IoRegisterFileSystem appelle les routines de notification des pilotes de filtre de système de fichiers qui se sont inscrits pour cette notification en appelant IoRegisterFsRegistrationChange ou IoRegisterFsRegistrationChangeEx.

Note Dans Microsoft Windows XP et versions ultérieures, lorsqu’un pilote de filtre de système de fichiers appelle IoRegisterFsRegistrationChange, sa routine de notification est également appelée immédiatement pour tous les systèmes de fichiers qui ont déjà appelé IoRegisterFileSystem.