Функция FltGetVolumeFromInstance (fltkernel.h)

Статья
02/06/2025

Подпрограмма 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 (include Fltkernel.h)
библиотеки	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

См. также

FltGetDeviceObject

FltGetFilterFromInstance

FltObjectDereference

FltQueryVolumeInformation

Поделиться через