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

Статья
08/07/2023

Подпрограмма FltSetEcpListIntoCallbackData присоединяет дополнительный список структуры контекста параметра создания (ECP) к объекту callback-data операции создания.

Синтаксис

NTSTATUS FLTAPI FltSetEcpListIntoCallbackData(
  [in] PFLT_FILTER        Filter,
       PFLT_CALLBACK_DATA CallbackData,
  [in] PECP_LIST          EcpList
);

Параметры

[in] Filter

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

CallbackData

Указатель на объект callback-data типа FLT_CALLBACK_DATA, представляющий операцию создания.

[in] EcpList

Указатель на список ECP, который содержит один или несколько ESP, которые должны быть присоединены к объекту callback-data.

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

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

Код возврата	Описание
STATUS_SUCCESS	Данный список ECP успешно присоединен к заданному объекту callback-data.
STATUS_INVALID_PARAMETER_2	Данный объект данных обратного вызова не был операцией создания на основе IRP.
STATUS_INVALID_PARAMETER_3	Список ECP уже присоединен к данному объекту callback-data.

Подпрограмма FltSetEcpListIntoCallbackData предоставляет механизм для передачи дополнительных параметров создания в стек фильтров файловой системы базовым минифильтрам и устаревшим драйверам фильтров.

Чтобы получить подключенный список ECP из заданного объекта callback-data, используйте подпрограмму FltGetEcpListFromCallbackData .

Требования

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