Funzione IoRegisterFsRegistrationChangeEx (ntifs.h)

  • Articolo

La routine IoRegisterFsRegistrationChangeEx registra una routine di notifica del driver di filtro file system da chiamare ogni volta che un file system registra o annulla la registrazione come file system attivo.

Sintassi

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

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.

Valore restituito

IoRegisterFsRegistrationChangeEx restituisce uno dei valori 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.

Commenti

L'effetto di IoRegisterFsRegistrationChangeEx è identico a quello di IoRegisterFsRegistrationChange in Windows XP e versioni successive.

IoRegisterFsRegistrationChangeEx registra un driver di filtro del file system da notificare 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 un driver di filtro del file system chiama IoRegisterFsRegistrationChangeEx, la routine di notifica viene chiamata immediatamente anche 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 IoRegisterFsRegistrationChangeEx restituisca , un driver di filtro non deve chiamare questa routine fino a quando non è stata creata alcuna struttura di dati che deve elaborare queste notifiche.

IoRegisterFsRegistrationChangeEx ignora i dispositivi RAW. Per informazioni sull'associazione al file system RAW in base al nome, vedere Collegamento dell'oggetto dispositivo filtro all'oggetto dispositivo di destinazione.

IoRegisterFsRegistrationChangeEx incrementa il conteggio dei riferimenti sull'oggetto driver del driver del filtro.

Se un driver di filtro del file system chiama due volte IoRegisterFsRegistrationChangeEx (senza chiamare IoUnregisterFsRegistrationChange tra), passando gli stessi valori per i parametri DriverObject e DriverNotificationRoutine registrati nella chiamata precedente a IoRegisterFsRegistrationChangeEx e nessun altro driver di filtro è registrato dalla prima chiamata, IoRegisterFsRegistrationChangeEx restituisce STATUS_DEVICE_ALREADY_ATTACHED.

Requisiti

Requisito Valore
Client minimo supportato Questa routine è disponibile solo nel sistema operativo Update Rollup per Windows 2000 Service Pack 4 (SP4).
Piattaforma di destinazione Desktop
Intestazione ntifs.h (include Ntifs.h)
IRQL <= APC_LEVEL

Vedi anche

IoRegisterFileSystem

IoRegisterFsRegistrationChange

IoUnregisterFileSystem

IoUnregisterFsRegistrationChange