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

Статья
03/08/2023

FsRtlNotifyFilterReportChange завершает IRP_MN_NOTIFY_CHANGE_DIRECTORY запросов, ожидающих в указанном списке уведомлений.

Синтаксис

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

Параметры

[in] NotifySync

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

[in] NotifyList

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

[in] FullTargetName

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

[in] TargetNameOffset

Offset (в байтах) в строке FullTargetName конечного компонента имени файла или каталога, которые были изменены.

[in, optional] StreamName

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

[in, optional] NormalizedParentName

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

[in] FilterMatch

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

[in] Action

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

[in, optional] TargetContext

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

[in, optional] FilterContext

Указатель контекста для передачи в подпрограмму обратного вызова фильтра. Дополнительные сведения см. в разделе Параметр FilterCallbackобъекта FsRtlNotifyFilterChangeDirectory.

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

None

Remarks

Файловая система, которая получила IRP с основным кодом функции IRP_MJ_DIRECTORY_CONTROL, дополнительный код функции IRP_MN_NOTIFY_CHANGE_DIRECTORY, вызывает FsRtlNotifyFilterChangeDirectory , чтобы создать структуру уведомлений для хранения IRP и добавить структуру уведомлений в список уведомлений для текущего тома.

При изменении каталога файловая система вызывает FsRtlNotifyFilterReportChange для выполнения ожидающих запросов IRP_MN_NOTIFY_CHANGE_DIRECTORY в списке уведомлений.

Требования

Требование	Значение
Минимальная версия клиента	Накопительный пакет обновления Windows 2000 с пакетом обновления 4 (SP4); Windows XP
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< APC_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

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

FsRtlNotifyFilterChangeDirectory

FsRtlNotifyFullChangeDirectory

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL

Share via