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

Статья
02/26/2024

Подпрограмма FltPrepareToReuseEcp сбрасывает дополнительную структуру контекста параметра создания (ECP), которая подготавливает ее к повторному использованию.

Синтаксис

VOID FLTAPI FltPrepareToReuseEcp(
  [in] PFLT_FILTER Filter,
  [in] PVOID       EcpContext
);

Параметры

[in] Filter

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

[in] EcpContext

Указатель на ECP для подготовки к повторному использованию.

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

Нет.

Remarks

FltPrepareToReuseEcp позволяет повторно использовать ECP, использованный в предыдущем запросе на создание. Это предотвращает инициализацию нового ECP с теми же сведениями.

Целевой объект ECP использует FltAcknowledgeEcp для пометки ECP как подтвержденного. Это означает, что ecp был обнаружен и обработан. Чтобы повторно использовать ранее подтвержденную ECP, например при обработке повторного обработки, драйвер может использовать FltPrepareToReuseEcp для очистки подтвержденного состояния из ECP перед отправкой его в другом запросе на создание.

Требования

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