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

Статья
08/07/2023

Подпрограмма 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 ).
STATUS_NOT_FOUND	Структура контекста ECP (как указано параметром EcpType ) не найдена в списке ECP (как указано в параметре EcpList ).

Требования

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