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_MJ_DIRECTORY_CONTROL、次要函式程式碼 IRP_MN_NOTIFY_CHANGE_DIRECTORY、呼叫 FsRtlNotifyFilterChangeDirectory 的文件系統，以建立通知結構來保存 IRP，並將通知結構新增至目前磁碟區的通知清單。

當目錄發生變更時，文件系統會呼叫 FsRtlNotifyFilterReportChange 來完成通知清單中的擱置IRP_MN_NOTIFY_CHANGE_DIRECTORY要求。

規格需求

需求 值
最低支援的用戶端 Windows 2000 SP4 更新匯總;Windowsxp
目標平台 Universal
標頭 ntifs.h (包含 Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL < APC_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) 、 PowerIrpDDis (wdm)

另請參閱

FsRtlNotifyFilterChangeDirectory

FsRtlNotifyFullChangeDirectory

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL