Функция FsRtlNotifyFullReportChange (ntifs.h)
Подпрограмма 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) |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по