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

Статья
08/07/2023

Подпрограмма FltInitExtraCreateParameterLookasideList инициализирует список просмотров постраничного или нестраничного пула, используемый для выделения одной или нескольких дополнительных структур контекста create (ECP) фиксированного размера.

Синтаксис

VOID FLTAPI FltInitExtraCreateParameterLookasideList(
  [in]      PFLT_FILTER               Filter,
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags,
  [in]      SIZE_T                    Size,
  [in]      ULONG                     Tag
);

Параметры

[in] Filter

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

[in, out] Lookaside

Указатель на непрозрачную PAGED_LOOKASIDE_LIST или NPAGED_LOOKASIDE_LIST структуру lookaside list-head. Для страничного или нестраничного списка lookaside структура list-head должна быть выделена из нестраничного пула.

[in] Flags

Определяет параметры выделения пула. Если параметр Flags содержит FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL битовое значение флага, подпрограмма инициализирует список lookaside для нестраничных записей ECP указанного размера. В противном случае подпрограмма инициализирует список lookaside для постраничных записей ECP указанного размера.

[in] Size

Задает размер в байтах для всех записей ECP в списке lookaside.

[in] Tag

Указывает тег пула, используемый при выделении записей ECP списка lookaside. Дополнительные сведения о тегах пула см. в разделе Параметр Tagобъекта ExAllocatePoolWithTag.

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

None

Remarks

Используйте эту подпрограмму для инициализации страничного или нестраничного списка просмотра пула. Используйте подпрограмму FltAllocateExtraCreateParameterFromLookasideList , чтобы выделить ECP из списка lookaside, и подпрограмму FltFreeExtraCreateParameter , чтобы вернуть буфер ECP в список lookaside для повторного использования.

Используйте процедуру FltDeleteExtraCreateParameterLookasideList , чтобы освободить сам список lookaside.

Драйверы должны освободить все ecp и списки lookaside, созданные перед выгрузками.

Дополнительные сведения об использовании списков lookaside с драйверами см. в статье Использование Списки Lookaside.

Требования

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