Функция 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