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