FltDeleteVolumeContext 函式 (fltkernel.h)

  • 發行項

FltDeleteVolumeContext 會移除指定迷你篩選驅動程式針對指定磁碟區設定的內容，並標記要刪除的內容。

語法

NTSTATUS FLTAPI FltDeleteVolumeContext(
  [in]            PFLT_FILTER  Filter,
  [in]            PFLT_VOLUME  Volume,
  [out, optional] PFLT_CONTEXT *OldContext
);

參數

[in] Filter

呼叫端的不透明篩選指標。

[in] Volume

磁碟區的不透明磁碟區指標。

[out, optional] OldContext

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

傳回值

FltDeleteVolumeContext 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，例如下列其中一項：

傳回碼 Description
STATUS_FLT_DELETING_OBJECT 指定的 磁碟區 正在卸除。 這是錯誤碼。
STATUS_NOT_FOUND 找不到相符的內容。 這是錯誤碼。

備註

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

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

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

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

若要取得磁碟區內容，請呼叫 FltGetVolumeContext。

若要設定磁碟區內容，請呼叫 FltSetVolumeContext。

規格需求

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

另請參閱

FltAllocateContext

FltDeleteContext

FltGetVolumeContext

FltReleaseContext

FltSetVolumeContext