共用方式為

FsRtlNotifyFullChangeDirectory 宏 (rxprocs.h)

  • 發行項

FsRtlNotifyFullChangeDirectory 例程會建立通知要求的通知結構，並將它新增至指定的通知清單。

語法

void FsRtlNotifyFullChangeDirectory(
   A1,
   A2,
   A3,
   A4,
   A5,
   A6,
   A7,
   A8,
   A9,
   A10
);

參數

A1

目前磁碟區的通知清單之不透明同步處理物件的指標。

A2

通知清單前端的指標。 清單中的每個元素都是不透明的通知結構。

A3

文件系統指派的唯一值的指標，用來識別要建立為屬於特定檔案物件的通知結構。 如果提供 TraverseCallback 例程，則會將 FsContext 當做 NotifyContext 參數傳遞至該例程。

A4

ANSI 或 Unicode 字串的指標，其中包含與此通知結構相關聯之目錄的完整名稱。 如果 NotifyIrp 為 NULL，則會忽略。

A5

如果也應該監看此目錄的所有子目錄，則設定為 TRUE 。 如果只監看目錄本身，則設定為 FALSE 。 如果 NotifyIrp 為 NULL，則會忽略。

A6

設定為 TRUE 可忽略任何用戶緩衝區，並強制繼續目錄。 此動作會加快作業的速度。 如果 NotifyIrp 為 NULL，則會忽略。

A7

旗標的位掩碼，指定檔案或子目錄的變更類型，這些變更應該會導致擱置的通知 IRP 佇列完成。 可能的旗標值如下所述。

旗標 意義

FILE_NOTIFY_CHANGE_FILE_NAME

此目錄中已新增、刪除或重新命名檔案。

FILE_NOTIFY_CHANGE_DIR_NAME

已建立、移除或重新命名子目錄。

FILE_NOTIFY_CHANGE_NAME

此目錄的名稱已變更。

FILE_NOTIFY_CHANGE_ATTRIBUTES

此檔案的屬性值已變更，例如上次存取時間。

FILE_NOTIFY_CHANGE_SIZE

此檔案的大小已變更。

FILE_NOTIFY_CHANGE_LAST_WRITE

此檔案上次修改時間已變更。

FILE_NOTIFY_CHANGE_LAST_ACCESS

此檔案上次存取時間已變更。

FILE_NOTIFY_CHANGE_CREATION

此檔案的建立時間已變更。

FILE_NOTIFY_CHANGE_EA

此檔案的擴充屬性已經過修改。

FILE_NOTIFY_CHANGE_SECURITY

此檔案的安全性資訊已變更。

FILE_NOTIFY_CHANGE_STREAM_NAME

檔案數據流已在此目錄中新增、刪除或重新命名。

FILE_NOTIFY_CHANGE_STREAM_SIZE

此檔案數據流的大小已變更。

FILE_NOTIFY_CHANGE_STREAM_WRITE

此檔案數據流的數據已變更。

 

如果 NotifyIrp 為 NULL，則會忽略 CompletionFilter。

A8

在通知變更時完成之 IRP 的指標。 如果 NotifyIrp 為 NULL，這表示正在刪除此檔案物件所代表的檔案數據流。

A9

在目錄樹狀結構中監看的子目錄中發生變更時，要叫用的回呼例程選擇性指標。 這可讓文件系統檢查監看員是否具有該目錄的周遊存取權。 這類呼叫端提供的例程宣告如下：

NTSTATUS
(*PCHECK_FOR_TRAVERSE_ACCESS) (
    IN PVOID NotifyContext,                     // FsContext
    IN PVOID TargetContext,                     // Context pointer
    IN PSECURITY_SUBJECT_CONTEXT SubjectContext // SubjectContext
    );

如需 TargetContext 參數的詳細資訊，請參閱 FsRtlNotifyFullReportChange 的 TargetContext 參數。 如果 NotifyIrp 為 NULL，則會忽略 TraverseCallback。

A10

要傳遞至 TraverseCallback 之內容結構的指標。 FsRtlNotifyFullChangeDirectory 會釋放內容，並在使用它之後釋放 結構。 如果 NotifyIrp 為 NULL，則會忽略。 如果提供 TraverseCallback 例程， SubjectContext 會當做 SubjectContext 參數傳遞至該例程。

傳回值

無

備註

FsRtlNotifyFullChangeDirectory 是由收到通知變更要求的文件系統所呼叫。 此要求會以具有主要函式程式代碼IRP_MJ_DIRECTORY_CONTROL、次要函式程式碼IRP_MN_NOTIFY_CHANGE_DIRECTORY的 IRP 接收。

如果 NotifyIrp 為 NULL，FsRtlNotifyFullChangeDirectory 會檢查通知清單是否包含參考此檔案物件的暫止 IRP，如果是的話，請使用STATUS_DELETE_PENDING完成。

如果 NotifyIrp 不是 NULL，FsRtlNotifyFullChangeDirectory 會執行下列動作：

  • 檢查檔案物件是否已進行清除。 如果是， FsRtlNotifyFullChangeDirectory 會以狀態STATUS_NOTIFY_CLEANUP完成通知 IRP。
  • 如果檔案物件尚未進行清除， FsRtlNotifyFullChangeDirectory 會檢查此磁碟區的通知清單是否已經包含這項變更的通知結構。 如果是， FsRtlNotifyFullChangeDirectory 會完成任何擱置的 IRP。 如果沒有， FsRtlNotifyFullChangeDirectory 會將通知 IRP 標示為擱置中、建立通知結構，並將它插入清單中。

規格需求

需求 值
目標平台 Universal
標頭 rxprocs.h (包含 Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm)

另請參閱

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL

SECURITY_SUBJECT_CONTEXT