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

Статья
02/06/2025

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

Синтаксис

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

Параметры

[in] Filter

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

CallbackData

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

[in] EcpList

Указатель на список ECP, содержащий один или несколько ECP, который должен быть присоединен к объекту обратного вызова данных.

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

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

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

Замечания

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

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

Требования

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