FsRtlLookupPerStreamContext 宏 (ntifs.h)

FsRtlLookupPerStreamContext 宏會擷取檔案數據流的每個數據流內容結構。

語法

void FsRtlLookupPerStreamContext(
   _sc,
   _oid,
   _iid
);

_sc

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

_oid

呼叫端配置的變數指標，可唯一識別每個數據流內容結構的擁有者。此變數的格式是篩選驅動程式 - 特定。如果為 InstanceId 提供非 NULL 值，則必須為非 NULL。

_iid

篩選驅動程式的指標 - 配置變數，可用來區分相同篩選驅動程式所建立的每個數據流內容結構。此變數的格式是篩選驅動程式 - 特定。

如果 OwnerId 和 InstanceId 都是 NULL，FsRtlLookupPerStreamContext 會傳回找到的第一個每個數據流內容。

如果為 OwnerId 提供非 NULL 值，且 InstanceId 為 NULL，FsRtlLookupPerStreamContext 會傳回其 OwnerId 成員符合 OwnerId 參數的第一個每個數據流內容。

無

文件系統篩選驅動程式會呼叫 FsRtlLookupPerStreamContext ，以擷取檔案數據流的個別數據流內容結構。每個數據流內容結構包含篩選驅動程式針對檔案數據流維護的內容資訊。

注意FsRtlLookupPerStreamContext 只能在支援每個數據流內容的文件系統上使用。

若要初始化每個數據流的內容結構，請使用 FsRtlInitPerStreamContext 宏。

若要將初始化的每個數據流內容結構與檔案數據流產生關聯，請呼叫 FsRtlInsertPerStreamContext。

若要移除與檔案數據流相關聯的個別數據流內容結構，請呼叫 FsRtlRemovePerStreamContext。