FltReleaseContext 函式 (fltkernel.h)
FltReleaseContext 會遞減內容上的參考計數。
語法
VOID FLTAPI FltReleaseContext(
[in] PFLT_CONTEXT Context
);
參數
[in] Context
內容的指標。 必須是磁碟區、實例、數據流或數據流句柄之內容物件的有效指標。 這個參數是必要的,而且不能是 NULL。
傳回值
無
備註
如需內容的詳細資訊,請參閱 關於迷你篩選內容。
迷你篩選驅動程式會呼叫 FltReleaseContext 來釋放內容。 FltReleaseContext 會遞減指定內容上的參考計數。 當參考計數達到零時,如果呼叫端在 IRQL <= APC_LEVEL 執行,就會立即釋放內容。 如果呼叫端在 IRQL DISPATCH_LEVEL執行,則會排定工作專案釋放內容。
注意
FltReleaseContext 傳回之後,呼叫端不得使用內容,因為內容可能已經釋放。
對 FltAllocateContext、 FltGetXxxContext 或 FltReferenceContext 的每個成功呼叫最終都必須與 FltReleaseContext 的呼叫相符。
請注意,FltSetXxxContext 所傳回的 OldContext 指標和用來呼叫 FltDeleteContext 的 Context 參數也必須在不再需要時呼叫 FltReleaseContext 來釋放。
若要配置新的內容,請呼叫 FltAllocateContext。
若要遞增內容上的參考計數,請呼叫 FltReferenceContext。
如需內容參考計數的詳細資訊,請參閱 參考內容。
如果內容是從非分頁集區配置, FltReleaseContext 的呼叫端必須在 IRQL <= DISPATCH_LEVEL執行。 如果內容是從分頁集區配置,呼叫端必須在 IRQL <= APC_LEVEL執行。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | fltkernel.h (包含 Fltkernel.h) |
程式庫 | FltMgr.lib |
Dll | Fltmgr.sys |
IRQL | 請參閱一節。 |