IoRegisterFileSystem-Funktion (ntifs.h)

Artikel
02/29/2024

Die IoRegisterFileSystem-Routine fügt der globalen Dateisystemwarteschlange das Steuerelementgerätobjekt eines Dateisystems hinzu.

Syntax

void IoRegisterFileSystem(
  [in] __drv_aliasesMem PDEVICE_OBJECT DeviceObject
);

Parameter

[in] DeviceObject

Zeiger auf das Steuerelementgerätobjekt für das Dateisystem.

Rückgabewert

Keine

Bemerkungen

IoRegisterFileSystem registriert ein Dateisystem als aktives Dateisystem, indem das Steuerelementgeräteobjekt des Dateisystems in die globale Dateisystemwarteschlange eingefügt wird, und erhöht die Verweisanzahl für das Steuerelementgerätobjekt des Dateisystems.

Der Gerätetyp des Dateisystemsteuerungsgeräteobjekts muss einer der folgenden Sein:

FILE_DEVICE_NETWORK_FILE_SYSTEM

FILE_DEVICE_CD_ROM_FILE_SYSTEM

FILE_DEVICE_DISK_FILE_SYSTEM

Wenn der Gerätetyp nicht einer dieser Werte ist, wird das Dateisystem nicht registriert.

Darüber hinaus muss das Dateisystemsteuerungsgeräteobjekt benannt werden. Wenn es nicht benannt ist, führt dies nicht dazu, dass der Aufruf von IoRegisterFileSystem fehlschlägt. Dateisystemfiltertreiber sowie viele Systemkomponenten und Supportroutinen verwenden diesen Namen jedoch, um die immer benannten Steuergeräteobjekte des Dateisystems von den Volumegeräteobjekten zu unterscheiden, die nie benannt werden.

Wenn das flag DO_LOW_PRIORITY_FILESYSTEM für das Steuergerätobjekt des Dateisystems festgelegt ist, wird das Geräteobjekt an der vorletzten Position in der Warteschlange eingefügt. (Das RAW-Dateisystem nimmt die letzte Position in der Warteschlange ein.) Wenn dieses Flag nicht festgelegt ist, wird das Geräteobjekt am Anfang der Warteschlange eingefügt.

IoRegisterFileSystem ruft die Benachrichtigungsroutinen von Dateisystemfiltertreibern auf, die sich für diese Benachrichtigung registriert haben, indem IoRegisterFsRegistrationChange oder IoRegisterFsRegistrationChangeEx aufgerufen wird.

Hinweis Wenn in Microsoft Windows XP und höher ein Dateisystemfiltertreiber IoRegisterFsRegistrationChange aufruft, wird die Benachrichtigungsroutine auch sofort für alle Dateisysteme aufgerufen, die bereits IoRegisterFileSystem aufgerufen haben.