FltInitExtraCreateParameterLookasideList 함수(fltkernel.h)

아티클
08/07/2023

FltInitExtraCreateParameterLookasideList 루틴은 고정 크기의 하나 이상의 추가 CREATE 매개 변수 컨텍스트 구조(ECP)를 할당하는 데 사용되는 페이징되거나 페이징되지 않은 풀 lookaside 목록을 초기화합니다.

구문

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 목록의 경우 페이지가 없는 풀에서 목록 머리 구조를 할당해야 합니다.

[in] Flags

풀 할당 옵션을 정의합니다. Flags 매개 변수에 FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL 비트 플래그 값이 포함된 경우 루틴은 지정된 크기의 페이징되지 않은 ECP 항목에 대한 lookaside 목록을 초기화합니다. 그렇지 않으면 루틴은 지정된 크기의 페이징된 ECP 항목에 대한 lookaside 목록을 초기화합니다.

[in] Size

lookaside 목록의 모든 ECP 항목에 대한 크기(바이트)를 지정합니다.

[in] Tag

lookaside 목록 ECP 항목을 할당할 때 사용할 풀 태그를 지정합니다. 풀 태그에 대한 자세한 내용은 ExAllocatePoolWithTag의 Tag 매개 변수를 참조하세요.

반환 값

없음

설명

이 루틴을 사용하여 페이징된 풀 또는 페이징되지 않은 풀 lookaside 목록을 초기화합니다. FltAllocateExtraCreateParameterFromLookasideList 루틴을 사용하여 lookaside 목록에서 ECP를 할당하고 FltFreeExtraCreateParameter 루틴을 사용하여 ECP 버퍼를 재생을 위해 lookaside 목록으로 반환합니다.

FltDeleteExtraCreateParameterLookasideList 루틴을 사용하여 lookaside 목록 자체를 해제합니다.

드라이버는 언로드하기 전에 만든 모든 ECP 및 lookaside 목록을 해제해야 합니다.

드라이버와 함께 lookaside 목록을 사용하는 방법에 대한 자세한 내용은 Lookaside Lists 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	FltInitExtraCreateParameterLookasideList 루틴은 Windows Vista부터 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	fltkernel.h(Fltkernel.h 포함)
라이브러리	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL