FsRtlNotifyFilterReportChange function

FsRtlNotifyFilterReportChange completes IRP_MN_NOTIFY_CHANGE_DIRECTORY requests that are pending in the specified notify list.

Syntax


VOID FsRtlNotifyFilterReportChange(
  _In_     PNOTIFY_SYNC NotifySync,
  _In_     PLIST_ENTRY  NotifyList,
  _In_     PSTRING      FullTargetName,
  _In_     USHORT       TargetNameOffset,
  _In_opt_ PSTRING      StreamName,
  _In_opt_ PSTRING      NormalizedParentName,
  _In_     ULONG        FilterMatch,
  _In_     ULONG        Action,
  _In_opt_ PVOID        TargetContext,
  _In_opt_ PVOID        FilterContext
);

Parameters

NotifySync [in]

Pointer to an opaque synchronization object for the change directory notify list that is pointed to by the NotifyList parameter.

NotifyList [in]

Pointer to the head of the change directory notify list for the current volume. Each element in the list is an opaque notify structure.

FullTargetName [in]

Pointer to an ANSI or Unicode string that contains the full pathname of the file or directory that changed.

TargetNameOffset [in]

Offset, in bytes, within the FullTargetName string of the final component of the file name for the file or directory that changed.

StreamName [in, optional]

Optional pointer to an ANSI or Unicode string that contains a stream name to store with the file name.

NormalizedParentName [in, optional]

Optional pointer to an ANSI or Unicode string that contains the same path as in the FullTargetName string, but with all short names replaced by the corresponding long names.

FilterMatch [in]

Bitmask of flags to be compared with the completion filter in the notify structure. If any of the corresponding bits in the completion filter are set, then a notify condition exists. For possible flag values, see the CompletionFilter parameter of FsRtlNotifyFilterChangeDirectory.

Action [in]

Specifies the action code to store in the user's buffer if present. For possible action code values, see the Action parameter of FsRtlNotifyFullReportChange.

TargetContext [in, optional]

Context pointer to pass to the file system if performing a traverse check in the case of a tree being watched. For more information, see the TraverseCallback parameter of FsRtlNotifyFilterChangeDirectory.

FilterContext [in, optional]

Context pointer to pass to the filter callback routine. For more information, see the FilterCallback parameter of FsRtlNotifyFilterChangeDirectory.

Return value

None

Remarks

A file system that has received an IRP with major function code IRP_MJ_DIRECTORY_CONTROL, minor function code IRP_MN_NOTIFY_CHANGE_DIRECTORY, calls FsRtlNotifyFilterChangeDirectory to create a notify structure to hold the IRP and add the notify structure to the notify list for the current volume.

When a change occurs to the directory, the file system calls FsRtlNotifyFilterReportChange to complete the pending IRP_MN_NOTIFY_CHANGE_DIRECTORY requests in the notify list.

Requirements

Target platform

Universal

Version

This routine is available on Update Rollup for Windows 2000 Service Pack 4 (SP4) and on Windows XP and later.

Header

Ntifs.h (include Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

< APC_LEVEL

See also

FsRtlNotifyFilterChangeDirectory
FsRtlNotifyFullChangeDirectory
FsRtlNotifyFullReportChange
IRP_MJ_DIRECTORY_CONTROL

 

 

Send comments about this topic to Microsoft

Show: