Funzione FsRtlRegisterFileSystemFilterCallbacks (ntifs.h)
I driver di filtro del file system e i file system chiamano la routine FsRtlRegisterFileSystemFilterCallbacks per registrare routine di callback di notifica da richiamare quando il file system sottostante esegue determinate operazioni.
Sintassi
NTSTATUS FsRtlRegisterFileSystemFilterCallbacks(
[in] _DRIVER_OBJECT *FilterDriverObject,
[in] PFS_FILTER_CALLBACKS Callbacks
);
Parametri
[in] FilterDriverObject
Puntatore all'oggetto driver per il driver del filtro o del file system.
[in] Callbacks
Puntatore a una struttura di FS_FILTER_CALLBACKS che contiene i punti di ingresso delle routine di callback di notifica fornite dal chiamante. Tutti i punti di ingresso di callback sono facoltativi e possono essere impostati su NULL.
Valore restituito
La routine FsRtlRegisterFileSystemFilterCallbacks può restituire uno dei valori di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | Le routine di callback sono state registrate correttamente. |
| STATUS_INSUFFICIENT_RESOURCES | FsRtlRegisterFileSystemFilterCallbacks ha rilevato un errore di allocazione del pool durante l'allocazione della memoria per archiviare le informazioni di callback. |
| STATUS_FSFILTER_OP_COMPLETED_SUCCESSFULLY | FsRtlRegisterFileSystemFilterCallbacks ha completato correttamente un'operazione FsFilter. |
| STATUS_FILE_LOCKED_WITH_ONLY_READERS | Il file è stato bloccato e tutti gli utenti del file possono solo leggere. |
| STATUS_FILE_LOCKED_WITH_WRITERS | Il file è stato bloccato e almeno un utente del file può scrivere |
| STATUS_INVALID_PARAMETER | Uno dei parametri non è valido. |
Commenti
I driver di filtro del file system e del file system devono chiamare FsRtlRegisterFileSystemFilterCallbacks dalla routine DriverEntry del driver.
FsRtlRegisterFileSystemFilterCallbacks registra le routine di callback di notifica specificate nel parametro Callbacks da richiamare quando le richieste per determinate operazioni file vengono inviate al file system sottostante.
I file system chiamano FsRtlRegisterFileSystemFilterCallbacks per impostare il membro di callback PreAcquireForSectionSynchronization della struttura FS_FILTER_CALLBACKS anziché usare l'elemento AcquireFileForNtCreateSection obsoleto.
Le routine di callback registrate da FsRtlRegisterFileSystemFilterCallbacks sostituiscono le routine di callback di I/O veloci seguenti, obsolete e non devono essere usate dai driver di filtro del file system:
- AcquireForCcFlush
- AcquireFileForNtCreateSection
- AcquireForModWrite
- ReleaseForCcFlush
- ReleaseFileForNtCreateSection
- ReleaseForModWrite
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP |
| Piattaforma di destinazione | Universale |
| Intestazione | ntifs.h (include Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |