Função FsRtlNotifyFilterReportChange (ntifs.h)

FsRtlNotifyFilterReportChange conclui IRP_MN_NOTIFY_CHANGE_DIRECTORY solicitações pendentes na lista de notificação especificada.

Sintaxe

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
);

Parâmetros

[in] NotifySync

Ponteiro para um objeto de sincronização opaco para a lista de notificação do diretório de alterações apontada pelo parâmetro NotifyList .

[in] NotifyList

Ponteiro para o cabeçalho da lista de notificação do diretório de alterações para o volume atual. Cada elemento na lista é uma estrutura de notificação opaca.

[in] FullTargetName

Ponteiro para uma cadeia de caracteres ANSI ou Unicode que contém o nome de caminho completo do arquivo ou diretório que foi alterado.

[in] TargetNameOffset

Deslocamento, em bytes, dentro da cadeia de caracteres FullTargetName do componente final do nome do arquivo para o arquivo ou diretório que foi alterado.

[in, optional] StreamName

Ponteiro opcional para uma cadeia de caracteres ANSI ou Unicode que contém um nome de fluxo a ser armazenado com o nome do arquivo.

[in, optional] NormalizedParentName

Ponteiro opcional para uma cadeia de caracteres ANSI ou Unicode que contém o mesmo caminho que na cadeia de caracteres FullTargetName , mas com todos os nomes curtos substituídos pelos nomes longos correspondentes.

[in] FilterMatch

Bitmask de sinalizadores a serem comparados com o filtro de conclusão na estrutura de notificação. Se qualquer um dos bits correspondentes no filtro de conclusão estiver definido, uma condição de notificação existirá. Para possíveis valores de sinalizador, consulte o parâmetro CompletionFilter de FsRtlNotifyFilterChangeDirectory.

[in] Action

Especifica o código de ação a ser armazenado no buffer do usuário, se presente. Para obter possíveis valores de código de ação, consulte o parâmetro Action de FsRtlNotifyFullReportChange.

[in, optional] TargetContext

Ponteiro de contexto a ser passado para o sistema de arquivos se estiver executando uma passagem marcar no caso de uma árvore ser observada. Para obter mais informações, consulte o parâmetro TraverseCallback de FsRtlNotifyFilterChangeDirectory.

[in, optional] FilterContext

Ponteiro de contexto a ser passado para a rotina de retorno de chamada de filtro. Para obter mais informações, consulte o parâmetro FilterCallback de FsRtlNotifyFilterChangeDirectory.

Retornar valor

Nenhum

Comentários

Um sistema de arquivos que recebeu um IRP com código de função principal IRP_MJ_DIRECTORY_CONTROL, código de função secundária IRP_MN_NOTIFY_CHANGE_DIRECTORY, chama FsRtlNotifyFilterChangeDirectory para criar uma estrutura de notificação para manter o IRP e adicionar a estrutura de notificação à lista de notificação para o volume atual.

Quando ocorre uma alteração no diretório, o sistema de arquivos chama FsRtlNotifyFilterReportChange para concluir as solicitações de IRP_MN_NOTIFY_CHANGE_DIRECTORY pendentes na lista de notificação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Pacote cumulativo de atualizações do Windows 2000 SP4; Windows XP
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< APC_LEVEL
Regras de conformidade da DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Confira também

FsRtlNotifyFilterChangeDirectory

FsRtlNotifyFullChangeDirectory

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL