Funzione FsRtlRegisterFileSystemFilterCallbacks (ntifs.h)

  • Articolo

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

Vedi anche

FS_FILTER_CALLBACKS