FsRtlSetupAdvancedHeader 函式 (ntifs.h)

  • 發行項

文件系統會使用 FsRtlSetupAdvancedHeader 宏來初始化 FSRTL_ADVANCED_FCB_HEADER 結構，以便與篩選內容搭配使用。

語法

void FsRtlSetupAdvancedHeader(
  PVOID       AdvHdr,
  PFAST_MUTEX FMutex
);

參數

AdvHdr

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

FMutex

初始化之快速 Mutex 的指標，將用來同步處理 對FSRTL_ADVANCED_FCB_HEADER 結構的存取。 快速 Mutex 必須從非分頁集區配置。

此參數可以是 Null。 如果呼叫端想要使用已經存在的快速 Mutex 物件，則應該將此參數設定為 NULL 。 如果 FastMutex 為 NULL，呼叫端必須明確設定數據流內容物件的 FastMutex 成員，以指向現有的快速Mutex。 (這可以在呼叫 FsRtlSetupAdvancedHeader.) 之前或之後完成

傳回值

無

備註

文件系統會使用 FsRtlSetupAdvancedHeader 宏來初始化 FSRTL_ADVANCED_FCB_HEADER 結構，以便與篩選內容搭配使用。

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

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

規格需求

需求 值
最低支援的用戶端 Windows XP
目標平台 桌面
標頭 ntifs.h (包含 Ntifs.h、Fltkernel.h)
IRQL <= APC_LEVEL

另請參閱

FSRTL_ADVANCED_FCB_HEADER

FSRTL_PER_STREAM_CONTEXT

FsRtlGetPerStreamContextPointer

FsRtlInitPerStreamContext

FsRtlInsertPerStreamContext

FsRtlLookupPerStreamContext

FsRtlRemovePerStreamContext

FsRtlSupportsPerStreamContexts

FsRtlTeardownPerStreamContexts