FsRtlInitExtraCreateParameterLookasideList 함수(ntifs.h)

아티클
02/29/2024

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

구문

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

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

[in] Size

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

[in] Tag

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

반환 값

없음

설명

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

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

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

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

요구 사항

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