FltGetStreamContext 函式 （fltkernel.h）
FltGetStreamContext 例程會擷取由指定迷你篩選驅動程序實例為檔案數據流設定的內容。
語法
NTSTATUS FLTAPI FltGetStreamContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *Context
);
參數
[in] Instance
要擷取其內容之迷你篩選驅動程序實例的不透明實例指標。
[in] FileObject
數據流之檔案物件的指標。
[out] Context
接收內容位址的呼叫端配置變數指標。 這是必要參數，且無法設定為 NULL。
傳回值
FltGetStreamContext 成功傳回要求的內容時，會傳回STATUS_SUCCESS。 否則，它會傳回適當的NTSTATUS值，例如下列其中一個：
| 傳回碼 | 描述 |
|---|---|
| STATUS_NOT_FOUND | 目前在此檔案上找不到相符的內容，因此 FltMgr 將 Context 設為 NULL_CONTEXT。 這是錯誤碼。 |
| STATUS_NOT_SUPPORTED | 檔案系統不支援此檔案數據流的每個數據流內容。 這是錯誤碼。 |
言論
如需內容的詳細資訊，請參閱 關於小型篩選內容。
FltGetStreamContext 擷取由指定迷你篩選驅動程序實例為檔案數據流設定的內容。
FltGetStreamContext 遞增 Context 參數指向的內容參考計數。 當不再需要此內容指標時，呼叫端必須藉由呼叫 FltReleaseContext來遞減其參考計數。 因此，FltGetStreamContext 的每個成功呼叫，都必須比對 FltReleaseContext的後續呼叫。
若要設定檔案資料流的內容，請呼叫 FltSetStreamContext。
若要設定新的內容，請呼叫 FltAllocateContext。
若要刪除資料流內容，請呼叫 FltDeleteStreamContext 或 FltDeleteContext。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 標頭 | fltkernel.h （包括 Fltkernel.h） |
| 連結庫 | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |