在舊版檔案系統篩選驅動程式中追蹤Per-File內容

注意

為了獲得最佳可靠性和效能，請使用 檔案系統迷你篩選驅動程式 搭配篩選管理員支援，而不是舊版檔案系統篩選驅動程式。 若要將舊版驅動程式移植到迷你篩選驅動程式，請參閱 移植舊版篩選驅動程式的指導方針。

舊版檔案系統篩選驅動程式可以將 FSRTL_PER_FILE_CONTEXT 物件與使用者定義的內容資訊結構建立關聯，以記錄檔案的內容資訊。

注意

並非所有檔案系統都支援個別檔案內容物件。 若要瞭解檔案是否與支援的檔案系統相關聯，請使用 FsRtlSupportsPerFileCoNtexts 宏。

使用 FsRtlInitPerFileCoNtext 宏初始化FSRTL_PER_FILE_CONTEXT物件。 然後使用 FsRtlInsertPerFileCoNtext 常式，將檔案與任意內容物件產生關聯。

使用 FsRtlGetPerFileCoNtextPointer 宏來取得檔案系統執行時間程式庫 (FSRTL) 套件用來追蹤檔案內容的指標。

篩選驅動程式可以使用 FsRtlLookupPerFileCoNtext 常式來尋找與檔案相關聯的檔案內容物件。 常式可以指定結構的擁有者或結構的實例，以縮小搜尋範圍。

篩選驅動程式可以使用 FsRtlRemovePerFileCoNtext移除內容物件。 常式可以指定結構的擁有者或結構的實例，以縮小搜尋範圍。

注意

只有在檔案仍在開啟時，才使用 FsRtlRemovePerFileCoNtext 常式來移除內容物件。 請勿將它與 FsRtlTeardownPerFileCoNtexts混淆。

檔案系統會呼叫 FsRtlTeardownPerFileCoNtexts ，釋放仍與個別檔案控制區塊結構相關聯的任何篩選內容， (FCB) 卸載它們。 FsRtlTeardownPerFileCoNtexts常式會呼叫每個篩選內容之 FSRTL_PER_FILE_CONTEXT 物件中指定的FreeCallback常式。