FltGetVolumeFromInstance 函式 (fltkernel.h)

發行項
03/01/2024

FltGetVolumeFromInstance 例程會傳回指定迷你篩選驅動程序實例所附加磁碟區的不透明指標。

語法

NTSTATUS FLTAPI FltGetVolumeFromInstance(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_VOLUME   *RetVolume
);

參數

[in] Instance

實例的不透明實例指標。

[out] RetVolume

呼叫端配置的變數指標，該變數會接收磁碟區的不透明指標。這個參數是必要的，而且不能是 NULL。

傳回值

FltGetVolumeFromInstance 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，例如：

傳回碼	Description
STATUS_FLT_DELETING_OBJECT	迷你篩選驅動程序實例所連結的磁碟區正在損毀。這是錯誤碼。

備註

FltGetVolumeFromInstance 會將取消參考新增至 RetVolume 參數中傳回的不透明磁碟區指標。當不再需要這個指標時，呼叫端必須呼叫 FltObjectDereference 來釋放它。因此，每次成功呼叫 FltGetVolumeFromInstance 時，都必須與 後續對 FltObjectDereference 的呼叫進行比對。

若要取得建立指定實例之迷你篩選驅動程式的不透明篩選指標，請呼叫 FltGetFilterFromInstance。

若要取得指定磁碟區的裝置物件的指標，請呼叫 FltGetDeviceObject。

若要取得指定實例所附加磁碟區的詳細資訊，請呼叫 FltQueryVolumeInformation。