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

Статья
02/06/2025

Подпрограмма 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, была ранее выделена подпрограммой FltAllocateExtraCreatePara meter.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Эта подпрограмма доступна начиная с Windows Vista.
целевая платформа	Всеобщий
заголовка	fltkernel.h (include Fltkernel.h)
библиотеки	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL