Funzione FsRtlNotifyFullReportChange (ntifs.h)
La routine FsRtlNotifyFullReportChange completa il runtime di integrazione delle modifiche in sospeso.
Sintassi
void FsRtlNotifyFullReportChange(
[in] PNOTIFY_SYNC NotifySync,
[in] PLIST_ENTRY NotifyList,
[in] PSTRING FullTargetName,
[in] USHORT TargetNameOffset,
[in, optional] PSTRING StreamName,
[in, optional] PSTRING NormalizedParentName,
[in] ULONG FilterMatch,
[in] ULONG Action,
[in, optional] PVOID TargetContext
);
Parametri
[in] NotifySync
Puntatore a un oggetto di sincronizzazione opaco per il volume corrente.
[in] NotifyList
Puntatore all'intestazione di un elenco di notifiche. Ogni elemento nell'elenco è una struttura di notifica opaca.
[in] FullTargetName
Puntatore a una stringa ANSI o Unicode che contiene il percorso completo del file.
[in] TargetNameOffset
Offset all'interno della stringa FullTargetName del componente finale del nome.
[in, optional] StreamName
Puntatore facoltativo a una stringa ANSI o Unicode che contiene un nome di flusso da archiviare con il nome del file.
[in, optional] NormalizedParentName
Puntatore facoltativo a una stringa ANSI o Unicode che contiene lo stesso percorso della stringa FullTargetName , ma con tutti i nomi brevi sostituiti dai nomi lunghi corrispondenti.
[in] FilterMatch
Maschera di bit dei flag da confrontare con il filtro di completamento nella struttura di notifica. Se uno dei bit corrispondenti nel filtro di completamento è impostato, esiste una condizione di notifica. Per i possibili valori di flag, vedere il parametro CompletionFilter di FsRtlNotifyFullChangeDirectory.
[in] Action
Specifica il codice azione da archiviare nel buffer dell'utente, se presente. Il codice azione può essere uno dei valori descritti di seguito.
| Codice azione | Significato |
|---|---|
| FILE_ACTION_ADDED | È stato creato un nuovo file o una sottodirectory. |
| FILE_ACTION_REMOVED | Un file o una sottodirectory è stato eliminato. |
| FILE_ACTION_MODIFIED | Un file o una sottodirectory è stato modificato (ma non è stato creato o eliminato). |
| FILE_ACTION_RENAMED_OLD_NAME | Si tratta del nome precedente di un file rinominato. |
| FILE_ACTION_RENAMED_NEW_NAME | Si tratta del nuovo nome di un file rinominato. |
| FILE_ACTION_ADDED_STREAM | È stato aperto un nuovo flusso. |
| FILE_ACTION_REMOVED_STREAM | Un flusso è stato chiuso. |
| FILE_ACTION_MODIFIED_STREAM | Un flusso è stato modificato (ma non aperto o chiuso). |
| FILE_ACTION_REMOVED_BY_DELETE | Un ID oggetto è stato rimosso dall'indice da un'operazione di eliminazione del file. |
| FILE_ACTION_ID_NOT_TUNNELLED | Impossibile eseguire il tunneling di un ID oggetto per un file perché l'ID oggetto corrisponde all'ID di un file già esistente. |
| FILE_ACTION_TUNNELLED_ID_COLLISION | Impossibile eseguire il tunneling di un ID oggetto per un file perché il file ha già un ID oggetto. |
[in, optional] TargetContext
Puntatore di contesto da passare al file system se si esegue un controllo di attraversamento nel caso di un albero controllato. Per altre informazioni, vedere il parametro TraverseCallback di FsRtlNotifyFullChangeDirectory.
Valore restituito
nessuno
Osservazioni
FsRtlNotifyFullReportChange viene chiamato da un file system quando viene modificato un file in modo che sia possibile completare gli IRP delle modifiche in sospeso.
FsRtlNotifyFullReportChange cerca una struttura di notifica nell'elenco di notifica che corrisponde al filtro e al nome percorso specificati. Se viene trovata una corrispondenza, FsRtlNotifyFullReportChange completa tutti i runtime di integrazione in sospeso per la struttura di notifica.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | ntifs.h (include Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |