FsRtlSetupAdvancedHeaderEx 巨集（ntifs.h）

發行項
12/22/2024

文件系統會使用 FsRtlSetupAdvancedHeaderEx 巨集來初始化 FSRTL_ADVANCED_FCB_HEADER 結構，以搭配數據流和檔案內容使用。

語法

void FsRtlSetupAdvancedHeaderEx(
   _advhdr,
   _fmutx,
   _fctxptr
);

參數

_advhdr

要初始化之 FSRTL_ADVANCED_FCB_HEADER 結構的指標。

_fmutx

初始化之快速 Mutex 的指標，將用來同步存取特定 FSRTL_ADVANCED_FCB_HEADER 成員。快速 Mutex 必須從非分頁集區配置。這個參數是選擇性的，而且可以 NULL。呼叫端應該將此參數設定為 NULL，如果他們想要使用已經存在的快速 Mutex 物件。如果 FastMutexNULL，則呼叫端必須明確設定數據流內容物件中包含的 FSRTL_ADVANCED_FCB_HEADER 結構 FastMutex 成員，以指向現有的快速 mutex。（這可以在呼叫 FsRtlSetupAdvancedHeaderEx之前或之後完成。

_fctxptr

檔案系統運行時間連結庫（FSRTL）用來追蹤檔案內容的指標字段指標。這個參數是選擇性的，而且可以 NULL。特別：

針對在 Windows Vista 之前發行的 windows 作業系統Microsoft，呼叫者必須將此參數設定為 NULL。
對於從 Windows Vista 開始的 Windows 作業系統：如果 FileContextSupportPointer 未 NULL，FileContextSupportPointer 必須是建立結構之文件系統之每個檔案結構內的 PVOID 變數指標。若要指出檔案系統驅動程式不支援檔案內容，呼叫端必須將 FileContextSupportPointer 設定為 NULL。

傳回值

沒有

言論

文件系統會使用 FsRtlSetupAdvancedHeaderEx 巨集來初始化FSRTL_ADVANCED_FCB_HEADER結構，以搭配數據流和檔案內容使用。

不再需要進階FCB標頭結構時，文件系統必須呼叫 FsRtlTeardownPerStreamContexts，以釋放所有相關聯的數據流和檔案內容結構。

如需詳細資訊，請參閱舊版文件系統篩選驅動程式中的追蹤 Per-Stream 內容。

要求

要求	價值
最低支援的用戶端	Microsoft Windows 2000 Service Pack 4 的更新匯總（SP4）：Windows XP
目標平臺	桌面
標頭	ntifs.h （include Ntifs.h， Fltkernel.h）
IRQL	PASSIVE_LEVEL