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執行。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | fltkernel.h (包括 Fltkernel.h) |
連結庫 | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | 請參閱一節。 |