fsRtlInsertPerStreamContext 函式 (ntifs.h)

FsRtlInsertPerStreamContext 例程會將文件系統篩選驅動程式的每個數據流內容結構與檔案數據流產生關聯。

語法

NTSTATUS FsRtlInsertPerStreamContext(
       PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
  [in] PFSRTL_PER_STREAM_CONTEXT  Ptr
);

PerStreamContext

檔案數據流FSRTL_ADVANCED_FCB_HEADER結構的指標。若要從檔案物件取得此指標，請使用 FsRtlGetPerStreamContextPointer 宏。

[in] Ptr

篩選驅動程式已配置和初始化之FSRTL_PER_STREAM_CONTEXT結構的指標。若要初始化這個結構，請使用 FsRtlInitPerStreamContext 宏。

FsRtlInsertPerStreamContext 會傳回下列其中一個 NTSTATUS 值：

傳回碼	Description
STATUS_SUCCESS	FsRtlInsertPerStreamContext 的呼叫成功。
STATUS_INVALID_DEVICE_REQUEST	基礎檔系統不支援篩選內容。

文件系統篩選驅動程式會呼叫 FsRtlInsertPerStreamContext ，將它自己的每個數據流內容結構與檔案數據流產生關聯。每個數據流內容結構包含篩選驅動程式為檔案數據流維護的內容資訊。

在個別數據流內容結構與檔案數據流相關聯之後，可以藉由呼叫 FsRtlLookupPerStreamContext 來擷取，或藉由呼叫 FsRtlRemovePerStreamContext 來加以移除。