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

Статья
04/27/2023

Подпрограмма FltGetStreamContext извлекает контекст, заданный для файлового потока заданным экземпляром драйвера минифильтра.

Синтаксис

NTSTATUS FLTAPI FltGetStreamContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

Параметры

[in] Instance

Указатель непрозрачного экземпляра для экземпляра драйвера минифильтра, контекст которого требуется извлечь.

[in] FileObject

Указатель на объект файла для потока.

[out] Context

Указатель на переменную, выделенную вызывающим объектом, которая получает адрес контекста. Этот параметр является обязательным и не может иметь значение NULL.

Возвращаемое значение

Функция FltGetStreamContext возвращает STATUS_SUCCESS при успешном возвращении запрошенного контекста. В противном случае возвращается соответствующее значение NTSTATUS, например одно из следующих значений:

Код возврата	Описание
STATUS_NOT_FOUND	В данный момент соответствующий контекст в этом файле не найден, поэтому FltMgr устанавливает для параметра Context значение NULL_CONTEXT. Это код ошибки.
STATUS_NOT_SUPPORTED	Файловая система не поддерживает контексты каждого потока для этого потока файлов. Это код ошибки.

FltGetStreamContext увеличивает количество ссылок в контексте, на который указывает параметр Context . Если этот указатель контекста больше не требуется, вызывающий объект должен уменьшать количество ссылок, вызывая FltReleaseContext. Таким образом, каждый успешный вызов FltGetStreamContext должен соответствовать последующему вызову FltReleaseContext.

Чтобы задать контекст для потока файлов, вызовите FltSetStreamContext.

Чтобы выделить новый контекст, вызовите FltAllocateContext.

Чтобы удалить контекст потока, вызовите Метод FltDeleteStreamContext или FltDeleteContext.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL