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

Статья
02/29/2024

Подпрограмма FltInsertExtraCreateParameter вставляет дополнительную структуру контекста параметра создания (ECP) в список ECP.

Синтаксис

NTSTATUS FLTAPI FltInsertExtraCreateParameter(
  [in]      PFLT_FILTER Filter,
  [in, out] PECP_LIST   EcpList,
  [in, out] PVOID       EcpContext
);

Параметры

[in] Filter

Указатель непрозрачного фильтра на драйвер минифильтра. Этот указатель однозначно идентифицирует драйвер минифильтра и остается неизменным до тех пор, пока драйвер минифильтра загружен.

[in, out] EcpList

Указатель на структуру списка ECP, к которой должна быть добавлена структура контекста ECP, предоставляемая параметром EcpContext .

[in, out] EcpContext

Указатель на структуру контекста ECP, добавляемую в список ECP, предоставляемую параметром EcpList .

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

FltInsertExtraCreateParameter возвращает одно из следующих значений NTSTATUS:

Код возврата	Описание
STATUS_SUCCESS	Указанная структура контекста ECP была успешно вставлена в данный список ECP.
STATUS_INVALID_PARAMETER	Указанная структура контекста ECP уже существует в заданном списке ECP. В контексте вставки списка ECP две структуры контекста ECP считаются идентичными, если они содержат одинаковые значения GUID.

Подпрограмма FltInsertExtraCreateParameter предполагает, что заданная структура контекста ECP, вставленная в данный список ECP, была ранее выделена подпрограммой FltAllocateExtraCreateParameter.

Каждая структура контекста ECP, вставленная в список ECP, должна иметь уникальное значение GUID. Это уникальное значение задается, когда структура контекста ECP выделяется подпрограммой FltAllocateExtraCreateParameter .

Требования

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