FltGetVolumeContext 函式 (fltkernel.h)

發行項
02/26/2024

FltGetVolumeContext 例程會擷取由指定迷你篩選驅動程式為磁碟區設定的內容。

語法

NTSTATUS FLTAPI FltGetVolumeContext(
  [in]  PFLT_FILTER  Filter,
  [in]  PFLT_VOLUME  Volume,
  [out] PFLT_CONTEXT *Context
);

參數

[in] Filter

呼叫端的不透明篩選指標。這個參數是必要的，而且不能是 NULL。

[in] Volume

要擷取其內容之磁碟區的不透明指標。這個參數是必要的，而且不能是 NULL。

[out] Context

接收所要求內容位址之呼叫端配置的變數指標。這個參數是必要的，而且無法設定為 NULL。

傳回值

FltGetVolumeContext 會在成功傳回要求的內容時傳回STATUS_SUCCESS。否則，它會傳回適當的NTSTATUS值，例如：

傳回碼	Description
STATUS_NOT_FOUND	目前在此檔案上找不到相符的內容，因此 FltMgr 將 Context 設定為 NULL_CONTEXT。這是錯誤碼。

備註

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

FltGetVolumeContext 會在 Context 參數指向的內容上遞增參考計數。不再需要此內容指標時，呼叫端必須藉由呼叫 FltReleaseContext 來遞減其參考計數。因此，對 FltGetVolumeContext 的每個成功呼叫都必須與 後續對 FltReleaseContext 的呼叫相符。

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

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

若要刪除磁碟區內容，請呼叫 FltDeleteVolumeContext 或 FltDeleteContext。