共用方式為


FltDeleteInstanceContext 函式 (fltkernel.h)

FltDeleteInstanceContext 會從指定的實例中移除內容,並標示要刪除的內容。

語法

NTSTATUS FLTAPI FltDeleteInstanceContext(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_CONTEXT  *OldContext
);

參數

[in] Instance

實例的不透明實例指標。

[out] OldContext

呼叫端配置的變數指標,該變數會接收已刪除內容的位址。 這個參數是選擇性的,而且可以是 NULL。 如果 OldContext 不是 NULL 且未指向 NULL_CONTEXT,則呼叫端會負責呼叫 FltReleaseContext 以在不再需要時釋放此內容。

傳回值

FltDeleteInstanceContext 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值,例如下列其中一項:

傳回碼 Description
STATUS_FLT_DELETING_OBJECT 指定的 實例 正在損毀。 這是錯誤碼。
STATUS_NOT_FOUND 找不到相符的內容。 這是錯誤碼。

備註

如需內容的詳細資訊,請參閱 關於迷你篩選內容

因為內容是參考計數,所以小型篩選驅動程式通常不需要呼叫 FltDeleteInstanceContext 之類的例程來明確刪除內容。

迷你篩選驅動程式會呼叫 FltDeleteInstanceContext ,以從實例移除內容,並標示要刪除的內容。 內容通常會立即釋放,除非有未處理的參考 (,例如,因為內容仍由另一個線程) 使用。

若要配置新的內容,請呼叫 FltAllocateContext

若要取得實例內容,請呼叫 FltGetInstanceContext

若要設定實例內容,請呼叫 FltSetInstanceContext

規格需求

需求
目標平台 Universal
標頭 fltkernel.h (包含 Fltkernel.h)
程式庫 FltMgr.lib
IRQL <= APC_LEVEL

另請參閱

FltAllocateContext

FltDeleteContext

FltGetInstanceContext

FltReleaseContext

FltSetInstanceContext