FltGetVolumeFromInstance 函式 （fltkernel.h）

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

語法

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

參數

[in] Instance

實例的不透明實例指標。

[out] RetVolume

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

傳回值

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

傳回碼	描述
STATUS_FLT_DELETING_OBJECT	迷你篩選驅動程序實例所附加的磁碟區正在被拆毀。 這是錯誤碼。

言論

FltGetVolumeFromInstance 會在 RetVolume 參數中傳回的不透明磁碟區指標新增 rundown 參考。 不再需要此指標時，呼叫端必須呼叫 FltObjectDereference來釋放它。 因此，FltGetVolumeFromInstance 的每個成功呼叫，都必須比對 FltObjectDereference的後續呼叫。

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

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

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

要求

要求	價值
目標平臺	普遍
標頭	fltkernel.h （包括 Fltkernel.h）
連結庫	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

另請參閱

FltGetDeviceObject

FltGetFilterFromInstance

FltObjectDereference

FltQueryVolumeInformation