FltReleaseContext 函式 (fltkernel.h)

發行項
02/26/2024

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執行。