RtlFindClearRuns 함수(wdm.h)

아티클
03/05/2024

RtlFindClearRuns 루틴은 지정된 비트맵 내에서 지정된 수의 지우기 비트 실행을 찾습니다.

구문

NTSYSAPI ULONG RtlFindClearRuns(
  [in]  PRTL_BITMAP     BitMapHeader,
  [out] PRTL_BITMAP_RUN RunArray,
  [in]  ULONG           SizeOfRunArray,
  [in]  BOOLEAN         LocateLongestRuns
);

매개 변수

[in] BitMapHeader

비트맵을 설명하는 RTL_BITMAP 구조체에 대한 포인터입니다. 이 구조체는 RtlInitializeBitMap 루틴에 의해 초기화되어야 합니다.

[out] RunArray

지정된 비트맵 변수에 있는 각 clear 실행의 비트 위치 및 길이에 대해 호출자가 할당한 배열의 첫 번째 요소에 대한 포인터입니다.

[in] SizeOfRunArray

이 요청을 충족할 수 있는 최대 지우기 실행 수를 지정합니다.

[in] LocateLongestRuns

TRUE이면 루틴이 전체 비트맵에서 찾을 수 있는 가장 긴 지우기 실행을 검색하도록 지정합니다. 그렇지 않으면 SizeOfRunArray에서 지정한 지우기 실행 수를 찾은 경우 루틴 검색이 중지됩니다.

반환 값

RtlFindClearRuns는 찾은 명확한 실행 수를 반환합니다.

설명

LocateLongestRuns가 TRUE이면 RunArray에 표시된 지우기 실행이 가장 긴 실행에서 최단값으로 정렬됩니다. 명확한 실행은 단일 비트로 구성됩니다.

비트맵 변수를 포함하는 메모리가 페이징 가능하거나 BitMapHeader의 메모리를 페이징할 수 있는 경우 RtlFindClearRuns 호출자는 IRQL <= APC_LEVEL 실행되어야 합니다. 그렇지 않으면 모든 IRQL에서 RtlFindClearRuns 를 호출할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000부터 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL(설명 섹션 참조)