Funzione IoRegisterFsRegistrationChangeMountAware (ntifs.h)

La routine IoRegisterFsRegistrationChangeMountAware registra la routine di notifica di un driver di filtro del file system. Questa routine di notifica viene chiamata ogni volta che un file system registra o annulla la registrazione come file system attivo.

Sintassi

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

Parametri

[in] DriverObject

Puntatore all'oggetto driver per il driver di filtro del file system.

[in] DriverNotificationRoutine

Puntatore alla routine PDRIVER_FS_NOTIFICATION , che il file system chiama quando registra o annulla la registrazione.

[in] SynchronizeWithMounts

Se impostato su TRUE, questa routine garantisce che non siano in corso operazioni di montaggio durante l'esecuzione di callback delle notifiche. Se impostato su FALSE, la routine non tenta di evitare conflitti con le operazioni di montaggio.

Valore restituito

Restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La routine di notifica è stata registrata correttamente.
STATUS_INSUFFICIENT_RESOURCES	Impossibile allocare un pacchetto di notifica per la routine di notifica.
STATUS_DEVICE_ALREADY_ATTACHED	Questo oggetto driver è già stato registrato con questa notifica.

Commenti

IoRegisterFsRegistrationChangeMountAware registra un driver di filtro del file system per ricevere una notifica ogni volta che un file system chiama IoRegisterFileSystem o IoUnregisterFileSystem.

Per interrompere la ricezione di tali notifiche, il driver di filtro deve chiamare IoUnregisterFsRegistrationChange.

Quando SynchronizeWithMounts viene specificato come TRUE, IoRegisterFsRegistrationChangeMountAware attende il completamento di tutte le operazioni di montaggio correnti e non consente l'avvio di nuove operazioni di montaggio fino al completamento di IoRegisterFsRegistrationChangeMountAware .

Nota Quando un driver di filtro del file system chiama IoRegisterFsRegistrationChangeMountAware, la routine di notifica viene chiamata immediatamente per tutti i file system attualmente registrati, ovvero i file system che hanno già chiamato IoRegisterFileSystem, ma non hanno ancora chiamato IoUnregisterFileSystem.

Poiché la routine di notifica del chiamante può essere chiamata anche prima che IoRegisterFsRegistrationChangeMountAware restituisca, un driver di filtro non deve chiamare questa routine fino a quando non ha creato strutture di dati necessarie per elaborare queste notifiche.

Inoltre, IoRegisterFsRegistrationChangeMountAware ignora i dispositivi RAW. Per informazioni su come connettersi al file system RAW in base al nome, vedere Collegamento dell'oggetto Dispositivo filtro all'oggetto dispositivo di destinazione.

 

IoRegisterFsRegistrationChangeMountAware incrementa il conteggio dei riferimenti per l'oggetto driver del driver del filtro.

Requisiti

Requisito	Valore
Client minimo supportato	La routine IoRegisterFsRegistrationChangeMountAware è Windows 7
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include FltKernel.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

Vedi anche

IoRegisterFileSystem

IoRegisterFsRegistrationChange

IoRegisterFsRegistrationChangeEx

IoUnregisterFileSystem

IoUnregisterFsRegistrationChange