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

Статья
08/07/2023

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

Синтаксис

NTSTATUS FLTAPI FltGetTransactionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PKTRANSACTION Transaction,
  [out] PFLT_CONTEXT  *Context
);

Параметры

[in] Instance

Указатель непрозрачного экземпляра для вызывающего объекта.

[in] Transaction

Указатель непрозрачной транзакции для транзакции, контекст которой извлекается.

[out] Context

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

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

FltGetTransactionContext возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например следующее:

Код возврата	Описание
STATUS_NOT_FOUND	Соответствующий контекст не найден. Это код ошибки.

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

Чтобы задать контекст для транзакции, вызовите FltSetTransactionContext.

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

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

Требования

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