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

Статья
02/29/2024

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

Синтаксис

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 callback-data .

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

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

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

Требования

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