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

Статья
02/06/2025

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

Синтаксис

NTSTATUS FLTAPI FltGetEcpListFromCallbackData(
  [in]  PFLT_FILTER        Filter,
        PFLT_CALLBACK_DATA CallbackData,
  [out] PECP_LIST          *EcpList
);

Параметры

[in] Filter

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

CallbackData

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

[out] EcpList

Получает указатель на список ECP, связанный с объектом callbackData callbackData.

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

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

Возвращаемый код	Описание
STATUS_SUCCESS	EcpList получил указатель на список ECP, связанный с данным объектом обратного вызова. Если объект обратного вызова не имеет связанного ECP, возвращается STATUS_SUCCESS и EcpList NULL.
STATUS_INVALID_PARAMETER	Данный объект обратного вызова данных не был операцией создания на основе IRP. В этом случае EcpList не определено.

Замечания

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

Требования

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