Funzione FsRtlNotifyFilterReportChange (ntifs.h)

  • Articolo

FsRtlNotifyFilterReportChange completa le richieste IRP_MN_NOTIFY_CHANGE_DIRECTORY in sospeso nell'elenco di notifiche specificato.

Sintassi

void FsRtlNotifyFilterReportChange(
  [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,
  [in, optional] PVOID        FilterContext
);

Parametri

[in] NotifySync

Puntatore a un oggetto di sincronizzazione opaco per l'elenco di notifiche della directory di modifica a cui punta il parametro NotifyList .

[in] NotifyList

Puntatore all'intestazione dell'elenco di notifiche della directory di modifica per il volume corrente. Ogni elemento nell'elenco è una struttura di notifica opaca.

[in] FullTargetName

Puntatore a una stringa ANSI o Unicode contenente il nome percorso completo del file o della directory modificata.

[in] TargetNameOffset

Offset, in byte, all'interno della stringa FullTargetName del componente finale del nome file per il file o la directory che è stata modificata.

[in, optional] StreamName

Puntatore facoltativo a una stringa ANSI o Unicode contenente un nome di flusso da archiviare con il nome del file.

[in, optional] NormalizedParentName

Puntatore facoltativo a una stringa ANSI o Unicode contenente 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 sono impostati uno dei bit corrispondenti nel filtro di completamento, esiste una condizione di notifica. Per i valori di flag possibili, vedere il parametro CompletionFilter di FsRtlNotifyFilterChangeDirectory.

[in] Action

Specifica il codice azione da archiviare nel buffer dell'utente, se presente. Per i possibili valori di codice azione, vedere il parametro Action di FsRtlNotifyFullReportChange.

[in, optional] TargetContext

Puntatore al 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 FsRtlNotifyFilterChangeDirectory.

[in, optional] FilterContext

Puntatore al contesto da passare alla routine di callback del filtro. Per altre informazioni, vedere il parametro FilterCallback di FsRtlNotifyFilterChangeDirectory.

Valore restituito

nessuno

Osservazioni

Un file system che ha ricevuto un'IRP con codice di funzione principale IRP_MJ_DIRECTORY_CONTROL, codice di funzione secondario IRP_MN_NOTIFY_CHANGE_DIRECTORY, chiama FsRtlNotifyFilterChangeDirectory per creare una struttura di notifica per contenere l'IRP e aggiungere la struttura di notifica all'elenco di notifica per il volume corrente.

Quando si verifica una modifica alla directory, il file system chiama FsRtlNotifyFilterReportChange per completare le richieste di IRP_MN_NOTIFY_CHANGE_DIRECTORY in sospeso nell'elenco di notifiche.

Requisiti

Requisito Valore
Client minimo supportato Aggiornamento cumulativo di Windows 2000 SP4; Windows XP
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < APC_LEVEL
Regole di conformità DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Vedi anche

FsRtlNotifyFilterChangeDirectory

FsRtlNotifyFullChangeDirectory

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL