通过

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 参数中返回的不透明卷指针的运行引用。 不再需要此指针时，调用方必须通过调用 FltObjectDereference释放它。 因此，对 FltGetVolumeFromInstance 的每个成功调用都必须匹配对 FltObjectDereference的后续调用。

若要获取创建给定实例的微型筛选器驱动程序的不透明筛选器指针，请调用 FltGetFilterFromInstance。

若要获取指向给定卷的设备对象的指针，请调用 FltGetDeviceObject。

若要获取有关给定实例附加到的卷的详细信息，请调用 FltQueryVolumeInformation。

要求

要求 价值
目标平台 普遍
标头 fltkernel.h （包括 Fltkernel.h）
库 FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

另请参阅

FltGetDeviceObject

FltGetFilterFromInstance

FltObjectDereference

FltQueryVolumeInformation