Função FsRtlNotifyFullReportChange (ntifs.h)

A rotina FsRtlNotifyFullReportChange é concluída com a alteração pendente de notificação dos IRPs.

Sintaxe

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

Parâmetros

[in] NotifySync

Um ponteiro para um objeto de sincronização opaco para o volume atual.

[in] NotifyList

Um ponteiro para o cabeçalho de uma lista de notificação. Cada elemento na lista é uma estrutura de notificação opaca.

[in] FullTargetName

Um ponteiro para uma cadeia de caracteres ANSI ou Unicode que contém o nome de caminho completo do arquivo.

[in] TargetNameOffset

Deslocamento dentro da cadeia de caracteres FullTargetName do componente final do nome.

[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

Uma máscara de bits de sinalizadores a ser comparada 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 obter valores de sinalizador possíveis, consulte o parâmetro CompletionFilter de FsRtlNotifyFullChangeDirectory.

[in] Action

Especifica o código de ação a ser armazenado no buffer do usuário, se presente. O código de ação pode ser um dos valores descritos a seguir.

Código de ação	Significado
FILE_ACTION_ADDED	Um novo arquivo ou subdiretório foi criado.
FILE_ACTION_REMOVED	Um arquivo ou subdiretório foi excluído.
FILE_ACTION_MODIFIED	Um arquivo ou subdiretório foi modificado (mas não foi criado ou excluído).
FILE_ACTION_RENAMED_OLD_NAME	Esse é o nome antigo de um arquivo que foi renomeado.
FILE_ACTION_RENAMED_NEW_NAME	Esse é o novo nome de um arquivo que foi renomeado.
FILE_ACTION_ADDED_STREAM	Um novo fluxo foi aberto.
FILE_ACTION_REMOVED_STREAM	Um fluxo foi fechado.
FILE_ACTION_MODIFIED_STREAM	Um fluxo foi modificado (mas não aberto ou fechado).
FILE_ACTION_REMOVED_BY_DELETE	Uma ID de objeto foi removida do índice por uma operação de exclusão de arquivo.
FILE_ACTION_ID_NOT_TUNNELLED	Uma ID de objeto para um arquivo não pôde ser encapsulada porque sua ID de objeto correspondia à ID de um arquivo já existente.
FILE_ACTION_TUNNELLED_ID_COLLISION	Uma ID de objeto para um arquivo não pôde ser encapsulada porque o arquivo já tem uma ID de objeto.

[in, optional] TargetContext

Ponteiro de contexto para passar para o sistema de arquivos se executar uma passagem marcar no caso de uma árvore sendo observada. Para obter mais informações, consulte o parâmetro TraverseCallback de FsRtlNotifyFullChangeDirectory.

Retornar valor

Nenhum

Comentários

FsRtlNotifyFullReportChange é chamado por um sistema de arquivos quando um arquivo é modificado para que a alteração pendente de notificação IRPs possa ser concluída.

FsRtlNotifyFullReportChange procura uma estrutura de notificação na lista de notificação que corresponda ao filtro e ao nome do caminho especificados. Se uma correspondência for encontrada, FsRtlNotifyFullReportChange concluirá todos os IRPs pendentes para a estrutura de notificação.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Confira também

FsRtlNotifyFullChangeDirectory