Функция FsRtlNotifyFullReportChange (ntifs.h)

Статья
08/07/2023

Подпрограмма FsRtlNotifyFullReportChange завершается в ожидании уведомления об изменении irP.

Синтаксис

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

Параметры

[in] NotifySync

Указатель на непрозрачный объект синхронизации для текущего тома.

[in] NotifyList

Указатель на заголовок списка уведомлений. Каждый элемент в списке является непрозрачной структурой уведомлений.

[in] FullTargetName

Указатель на строку ANSI или Юникода, содержащую полный путь к файлу.

[in] TargetNameOffset

Смещение в строке FullTargetName конечного компонента имени.

[in, optional] StreamName

Необязательный указатель на строку ANSI или Юникода, содержащую имя потока для хранения с именем файла.

[in, optional] NormalizedParentName

Необязательный указатель на строку ANSI или Юникода, которая содержит тот же путь, что и в строке FullTargetName , но со всеми короткими именами, замененными соответствующими длинными именами.

[in] FilterMatch

Битовая маска флагов, сравниваемая с фильтром завершения в структуре уведомлений. Если задан какой-либо из соответствующих битов в фильтре завершения, то существует условие уведомления. Возможные значения флагов см. в параметре CompletionFilterпараметра FsRtlNotifyFullChangeDirectory.

[in] Action

Указывает код действия, который будет храниться в буфере пользователя, если он имеется. Код действия может быть одним из значений, описанных ниже.

Код действия	Значение
FILE_ACTION_ADDED	Создан новый файл или подкаталог.
FILE_ACTION_REMOVED	Файл или подкаталог удален.
FILE_ACTION_MODIFIED	Файл или подкаталог были изменены (но не созданы или удалены).
FILE_ACTION_RENAMED_OLD_NAME	Это старое имя переименованного файла.
FILE_ACTION_RENAMED_NEW_NAME	Это новое имя переименованного файла.
FILE_ACTION_ADDED_STREAM	Открыт новый поток.
FILE_ACTION_REMOVED_STREAM	Поток закрыт.
FILE_ACTION_MODIFIED_STREAM	Поток был изменен (но не открыт или закрыт).
FILE_ACTION_REMOVED_BY_DELETE	Идентификатор объекта был удален из индекса операцией удаления файла.
FILE_ACTION_ID_NOT_TUNNELLED	Идентификатор объекта для файла не может быть туннелирован, так как его идентификатор объекта совпадает с идентификатором уже существующего файла.
FILE_ACTION_TUNNELLED_ID_COLLISION	Не удалось туннелировать идентификатор объекта для файла, так как файл уже имеет идентификатор объекта.

[in, optional] TargetContext

Указатель контекста, передаваемый в файловую систему при выполнении обхода проверка в случае отслеживаемого дерева. Дополнительные сведения см. в разделе Параметр TraverseCallbackдля FsRtlNotifyFullChangeDirectory.

Возвращаемое значение

None

Remarks

FsRtlNotifyFullReportChange вызывается файловой системой при изменении файла, чтобы можно было завершить выполнение ожидающих уведомлений об изменениях.

FsRtlNotifyFullReportChange ищет в списке уведомлений структуру уведомлений, соответствующую указанному фильтру и имени пути. Если совпадение найдено, FsRtlNotifyFullReportChange завершает все ожидающие IRP для структуры уведомлений.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

См. также раздел

FsRtlNotifyFullChangeDirectory

Поделиться через