Функция FsRtlInitExtraCreateParameterLookasideList (ntifs.h)

Статья
12/20/2024

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

Синтаксис

void FsRtlInitExtraCreateParameterLookasideList(
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags,
  [in]      SIZE_T                    Size,
  [in]      ULONG                     Tag
);

Параметры

[in, out] Lookaside

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

[in] Flags

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

[in] Size

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

[in] Tag

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

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

Никакой

Замечания

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

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

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Подпрограмма FsRtlInitExtraCreateParameterLookasideList доступна начиная с Windows Vista.
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL