Funzione IoRegisterFileSystem (ntifs.h)

Articolo
02/26/2024

La routine IoRegisterFileSystem aggiunge l'oggetto dispositivo di controllo di un file system alla coda globale del file system.

Sintassi

void IoRegisterFileSystem(
  [in] __drv_aliasesMem PDEVICE_OBJECT DeviceObject
);

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo di controllo per il file system.

Valore restituito

nessuno

Osservazioni

IoRegisterFileSystem registra un file system come file system attivo inserendo l'oggetto dispositivo di controllo del file system nella coda globale del file system e incrementa il conteggio dei riferimenti sull'oggetto dispositivo di controllo del file system.

Il tipo di dispositivo del controllo del file system dell'oggetto dispositivo deve essere uno dei seguenti:

FILE_DEVICE_NETWORK_FILE_SYSTEM

FILE_DEVICE_CD_ROM_FILE_SYSTEM

FILE_DEVICE_DISK_FILE_SYSTEM

Se il tipo di dispositivo non è uno di questi valori, il file system non viene registrato.

Inoltre, l'oggetto dispositivo di controllo del file system deve essere denominato. Se non è denominato, la chiamata a IoRegisterFileSystem non riesce. Tuttavia, i driver di filtro del file system, oltre a molti componenti di sistema e routine di supporto, usano questo nome per distinguere gli oggetti dispositivo di controllo del file system, che vengono sempre denominati, dai relativi oggetti dispositivo volume, che non vengono mai denominati.

Se il flag DO_LOW_PRIORITY_FILESYSTEM è impostato sull'oggetto dispositivo di controllo del file system, l'oggetto dispositivo viene inserito nella posizione successiva all'ultima nella coda. Il file system RAW occupa l'ultima posizione nella coda. Se questo flag non è impostato, l'oggetto dispositivo viene inserito all'inizio della coda.

IoRegisterFileSystem chiama le routine di notifica dei driver di filtro del file system registrati per questa notifica chiamando IoRegisterFsRegistrationChange o IoRegisterFsRegistrationChangeEx.

Nota In Microsoft Windows XP e versioni successive, quando un driver di filtro del file system chiama IoRegisterFsRegistrationChange, la routine di notifica viene chiamata immediatamente per tutti i file system che hanno già chiamato IoRegisterFileSystem.