IoRegisterFsRegistrationChangeMountAware-Funktion (ntifs.h)

  • Artikel

Die IoRegisterFsRegistrationChangeMountAware-Routine registriert die Benachrichtigungsroutine eines Dateisystemfiltertreibers. Diese Benachrichtigungsroutine wird immer dann aufgerufen, wenn sich ein Dateisystem als aktives Dateisystem registriert oder die Registrierung aufhebt.

Syntax

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

Parameter

[in] DriverObject

Ein Zeiger auf das Treiberobjekt für den Dateisystemfiltertreiber.

[in] DriverNotificationRoutine

Ein Zeiger auf die PDRIVER_FS_NOTIFICATION Routine, die das Dateisystem aufruft, wenn die Registrierung selbst registriert oder aufgehoben wird.

[in] SynchronizeWithMounts

Wenn true festgelegt ist, stellt diese Routine sicher, dass keine Bereitstellungsvorgänge ausgeführt werden, wenn Benachrichtigungsrückrufe durchgeführt werden. Wenn dieser Wert auf FALSE festgelegt ist, versucht die Routine nicht, Konflikte mit Einbindungsvorgängen zu vermeiden.

Rückgabewert

Gibt einen der folgenden NTSTATUS-Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
 Die Benachrichtigungsroutine wurde erfolgreich registriert.
STATUS_INSUFFICIENT_RESOURCES
 Ein Benachrichtigungspaket konnte für die Benachrichtigungsroutine nicht zugeordnet werden.
STATUS_DEVICE_ALREADY_ATTACHED
 Dieses Treiberobjekt wurde bereits mit dieser Benachrichtigung registriert.

Hinweise

IoRegisterFsRegistrationChangeMountAware registriert einen Dateisystemfiltertreiber, um benachrichtigt zu werden, wenn ein Dateisystem IoRegisterFileSystem oder IoUnregisterFileSystem aufruft.

Um den Empfang solcher Benachrichtigungen zu beenden, sollte der Filtertreiber IoUnregisterFsRegistrationChange aufrufen.

Wenn SynchronizeWithMounts als TRUE angegeben wird, wartet IoRegisterFsRegistrationChangeMountAware auf den Abschluss aller aktuellen Bereitstellungsvorgänge und lässt den Beginn neuer Einbindungsvorgänge erst zu, wenn IoRegisterFsRegistrationChangeMountAware abgeschlossen ist.

Hinweis Wenn ein Dateisystemfiltertreiber IoRegisterFsRegistrationChangeMountAware aufruft, wird seine Benachrichtigungsroutine auch sofort für alle Dateisysteme aufgerufen, die derzeit registriert sind, d. h. Dateisysteme, die bereits IoRegisterFileSystem aufgerufen haben, aber noch nicht IoUnregisterFileSystem aufgerufen haben.

Da die Benachrichtigungsroutine des Aufrufers bereits vor der Rückgabe von IoRegisterFsRegistrationChangeMountAware aufgerufen werden kann, sollte ein Filtertreiber diese Routine erst aufrufen, nachdem er Datenstrukturen erstellt hat, die er zum Verarbeiten dieser Benachrichtigungen benötigt.

Darüber hinaus ignoriert IoRegisterFsRegistrationChangeMountAware RAW-Geräte. Informationen zum Anfügen an das RAW-Dateisystem anhand des Namens finden Sie unter Anfügen des Filtergeräteobjekts an das Zielgeräteobjekt.

 
IoRegisterFsRegistrationChangeMountAware erhöht die Verweisanzahl für das Treiberobjekt des Filtertreibers.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Die IoRegisterFsRegistrationChangeMountAware-Routine ist Windows 7.
Zielplattform Universell
Header ntifs.h (include FltKernel.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Weitere Informationen

IoRegisterFileSystem

IoRegisterFsRegistrationChange

IoRegisterFsRegistrationChangeEx

IoUnregisterFileSystem

IoUnregisterFsRegistrationChange