FltGetSectionContext 函式 (fltkernel.h)
FltGetSectionContext 例程會擷取由指定迷你篩選驅動程序實例為檔案數據流所建立的區段內容。
語法
NTSTATUS FLTAPI FltGetSectionContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *Context
);
參數
[in] Instance
要擷取其內容之迷你篩選驅動程序實例的不透明實例指標。
[in] FileObject
數據流之檔案物件的指標。
[out] Context
接收內容位址之呼叫端配置的變數指標。 這個參數是必要的，而且無法設定為 NULL。
傳回值
FltGetSectionContext 會在成功傳回要求的區段內容時傳回STATUS_SUCCESS。 否則，它會傳回適當的NTSTATUS值，例如下列其中一項：
| 傳回碼 | Description |
|---|---|
| STATUS_NOT_FOUND | 目前在此檔案上找不到相符的內容，因此 FltMgr 將 Context 設定為 NULL_CONTEXT。 這是錯誤碼。 |
| STATUS_NOT_SUPPORTED | 附加至這個實例的磁碟區不支援區段內容。 這是錯誤碼。 |
備註
如需內容的詳細資訊，請參閱 關於迷你篩選內容。
FltGetSectionContext 會擷取由指定迷你篩選驅動程序實例為檔案數據流所建立的區段內容。 區段內容是藉由呼叫 FltCreateSectionForDataScan 來建立。
FltGetSectionContext 會遞增 Context 參數指向的內容參考計數。 不再需要此內容指標時，呼叫端必須藉由呼叫 FltReleaseContext 來遞減其參考計數。 因此，對 FltGetSectionContext 的每個成功呼叫都必須與 後續對 FltReleaseContext 的呼叫進行比對。
若要配置新的內容，請呼叫 FltAllocateContext。
Minifilters 不得明確刪除傳遞至 FltCreateSectionForDataScan 的區段內容。 在此案例中，區段內容會藉由呼叫 FltCloseSectionForDataScan ，從數據流解除分配和移除。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 目標平台 | Universal |
| 標頭 | fltkernel.h (包含 Fltkernel.h) |
| 程式庫 | FltMgr.lib |
| Dll | Fltmgr.sys |
| IRQL | <= APC_LEVEL |