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

Статья
02/06/2025

FltFindExtraCreateParameter выполняет поиск заданного списка ECP для структуры контекста ECP заданного типа и возвращает указатель на эту структуру, если она найдена.

Синтаксис

NTSTATUS FLTAPI FltFindExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out, optional] PVOID       *EcpContext,
  [out, optional] ULONG       *EcpContextSize
);

Параметры

[in] Filter

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

[in] EcpList

Указатель на структуру списка ECP, в которой выполняется поиск структуры контекста ECP (с учетом параметра EcpType).

[in] EcpType

Указатель на GUID, однозначно определяющий каждую структуру контекста ECP. Это значение GUID используется подпрограммой FltFindExtraCreateParamter, чтобы определить, существует ли структура контекста ECP в списке ECP (с учетом параметра EcpList).

[out, optional] EcpContext

Необязательный параметр, который получает указатель на найденную структуру контекста ECP. Если структура контекста ECP не найдена в списке ECP, EcpContext имеет значение NULL. Если EcpContext задано значение NULL вызывающей стороны, возвращаемое значение этой подпрограммы можно использовать для определения того, находится ли структура контекста ECP в списке ECP.

[out, optional] EcpContextSize

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

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

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

Возвращаемый код	Описание
STATUS_SUCCESS	Структура контекста ECP (как указано параметром EcpType) была найдена в списке ECP (как указано параметром ecpList EcpList).
STATUS_NOT_FOUND	Структура контекста ECP (как указано параметром EcpType) не найдена в списке ECP (как указано в параметре EcpList).

Требования

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