通过

FsRtlNotifyFilterReportChange 函数 (ntifs.h)

  • 项目

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 或 Unicode 字符串的指针，该字符串包含已更改的文件或目录的完整路径名。

[in] TargetNameOffset

偏移量（以字节为单位），位于已更改的文件或目录的文件名的最终组件的 FullTargetName 字符串内。

[in, optional] StreamName

指向 ANSI 或 Unicode 字符串的可选指针，该字符串包含要随文件名一起存储的流名称。

[in, optional] NormalizedParentName

指向 ANSI 或 Unicode 字符串的可选指针，该字符串包含与 FullTargetName 字符串中相同的路径，但所有短名称都替换为相应的长名称。

[in] FilterMatch

要与通知结构中的完成筛选器进行比较的标志的位掩码。 如果设置了完成筛选器中的任何相应位，则存在通知条件。 有关可能的标志值，请参阅 FsRtlNotifyFilterChangeDirectory 的 CompletionFilter 参数。

[in] Action

指定要存储在用户缓冲区中的操作代码（如果存在）。 有关可能的操作代码值，请参阅 FsRtlNotifyFullReportChange 的 Action 参数。

[in, optional] TargetContext

如果在监视树的情况下执行遍历检查，则传递给文件系统的上下文指针。 有关详细信息，请参阅 FsRtlNotifyFilterChangeDirectory 的 TraverseCallback 参数。

[in, optional] FilterContext

要传递给筛选器回调例程的上下文指针。 有关详细信息，请参阅 FsRtlNotifyFilterChangeDirectory 的 FilterCallback 参数。

返回值

无

备注

已收到 IRP 的文件系统，其中包含主要函数代码 IRP_MJ_DIRECTORY_CONTROL，次要函数代码IRP_MN_NOTIFY_CHANGE_DIRECTORY，调用 FsRtlNotifyFilterChangeDirectory 来创建一个通知结构来保存 IRP，并将通知结构添加到当前卷的通知列表。

当目录发生更改时，文件系统会调用 FsRtlNotifyFilterReportChange 以完成通知列表中的挂起IRP_MN_NOTIFY_CHANGE_DIRECTORY请求。

要求

要求 值
最低受支持的客户端 Windows 2000 SP4 更新汇总;Windowsxp
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < APC_LEVEL
DDI 符合性规则 HwStorPortProhibitedDDI (storport) ， PowerIrpDDis (wdm)

另请参阅

FsRtlNotifyFilterChangeDirectory

FsRtlNotifyFullChangeDirectory

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL