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

Статья
02/29/2024

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

Синтаксис

NTSTATUS FLTAPI FltGetNextExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in, optional]  PVOID       CurrentEcpContext,
  [out, optional] LPGUID      NextEcpType,
  [out, optional] PVOID       *NextEcpContext,
  [out, optional] ULONG       *NextEcpContextSize
);

Параметры

[in] Filter

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

[in] EcpList

Указатель на список ECP для проверки.

[in, optional] CurrentEcpContext

Необязательный указатель на ECP в заданном списке ECP. Если параметр имеется, Функция FltGetNextExtraCreateParameter возвращает ecp после текущего ECP-объекта CurrentEcpContext . Если параметр CurrentEcpContext имеет значение NULL, Функция FltGetNextExtraCreateParameter возвращает первый ECP в списке.

[out, optional] NextEcpType

Необязательный параметр, получающий указатель на GUID возвращаемого ECP.

[out, optional] NextEcpContext

Необязательный параметр, получающий указатель на возвращенный ECP.

[out, optional] NextEcpContextSize

Необязательный параметр, получающий размер возвращаемого ECP (в байтах).

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

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

Код возврата	Описание
STATUS_SUCCESS	В списке ECP EcpList найдена платформа ECP.
STATUS_NOT_FOUND	Список ECP EcpList пуст или CurrentEcpContext является последним элементом ECP в списке, то есть нет следующего элемента списка ECP). Кроме того, nextEcpContext имеет значение NULL , а NextEcpContextSize — нулевое значение.
STATUS_INVALID_PARAMETER	Параметр EcpList имеет значение NULL.

ПодпрограммаFltGetNextExtraCreateParameter обрабатывает список ECP некруговым образом. То есть, если ECP, на который указывает параметр CurrentEcpContext , является последним элементом ECP в списке ECP, то в списке отсутствует "next" ECP, и подпрограмма возвращает STATUS_NOT_FOUND.

Требования

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