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

Статья
02/06/2025

Подпрограмма 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 после CurrentEcpContext ECP. Если CurrentEcpContextNULL, 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. Кроме того, для NextEcpContext задано значение NULL, а NextEcpContextSize равно нулю.
STATUS_INVALID_PARAMETER	Параметр EcpList NULL.

Замечания

Эта подпрограмма доступна начиная с Windows Vista.

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

Требования

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