FsRtlAllocateAePushLock 함수(ntifs.h)

FsRtlAllocateAePushLock 자동 확장 푸시 잠금을 할당하고 초기화합니다.

통사론

PVOID FsRtlAllocateAePushLock(
  [in] POOL_TYPE PoolType,
  [in] ULONG     Tag
);

매개 변수

[in] PoolType

자동 확장 푸시 잠금에 할당할 풀 메모리의 형식입니다. 사용 가능한 풀 메모리 유형에 대한 설명은 POOL_TYPE 참조하세요. PoolType 값을 POOL_RAISE_IF_ALLOCATION_FAILURE 플래그로 비트 ORing하여 수정할 수 있습니다. 이 플래그는 할당 요청을 충족할 수 없는 경우 예외가 발생합니다.

[in] Tag

할당된 메모리에 사용할 풀 태그입니다. 풀 태그를 작은따옴표(예: 'Tag1')로 구분된 1~4자의 0이 아닌 문자 리터럴로 지정합니다. 문자열은 일반적으로 역순으로 지정됩니다(예: '1gaT'). 태그의 각 ASCII 문자는 0x7E 범위 0x20(공백)의 값이어야 합니다(타일). 각 할당 코드 경로는 디버거와 검증 도구가 코드 경로를 식별하는 데 도움이 되도록 고유한 풀 태그를 사용해야 합니다.

반환 값

FsRtlAllocateAePushLock 요청을 충족하기 위해 사용 가능한 풀에 메모리가 부족한 경우 NULL을 반환합니다. 그렇지 않으면 루틴은 할당되고 초기화된 자동 확장 푸시 잠금에 대한 포인터를 반환합니다.

발언

FsRtlAllocateAePushLock 자동 확장 푸시 잠금에 풀 메모리를 할당하는 데 사용됩니다. 자동 확장 푸시 잠금에 대한 자세한 내용은 FSRTL_ADVANCED_FCB_HEADER 참조하세요.

시스템은 풀 태그를 할당된 메모리와 연결합니다. WinDbg같은 프로그래밍 도구는 할당된 각 버퍼와 연결된 풀 태그를 표시할 수 있습니다. windows디버깅 도구에 포함된 도구인 Gflags특정 풀 태그에 대한 특수 풀 할당을 요청하는 시스템 기능을 설정합니다. WDK에 포함된 Poolmon풀 태그별로 메모리를 추적합니다.

FsRtlAllocateAePushLock 호출자는 이후에 FsRtlFreeAePushLock 호출하여 할당된 자동 확장 푸시 잠금을 해제해야 합니다.

시스템은 풀의 양(페이징 또는 페이징되지 않은)이 높거나 낮을 때 특정 표준 이벤트 개체를 자동으로 설정합니다. 드라이버는 이러한 이벤트가 풀 사용량을 튜닝할 때까지 기다릴 수 있습니다. 자세한 내용은 표준 이벤트 개체참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 10 버전 20H2
헤더	ntifs.h
IRQL	<= APC_LEVEL

참고 항목

FSRTL_ADVANCED_FCB_HEADER

FsRtlFreeAePushLock

FsRtlSetupAdvancedHeaderEx2