RtlFindFirstRunClear 함수(wdm.h)

아티클
08/08/2023

RtlFindFirstRunClear 루틴은 지정된 비트맵 내에서 초기 연속 비트 범위를 검색합니다.

구문

NTSYSAPI ULONG RtlFindFirstRunClear(
  [in]  PRTL_BITMAP BitMapHeader,
  [out] PULONG      StartingIndex
);

매개 변수

[in] BitMapHeader

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

[out] StartingIndex

비트맵에서 초기 지우기 실행의 시작 인덱스가 반환되는 변수에 대한 포인터입니다. 반환된 범위에서 첫 번째 지우기 비트의 비트 위치를 나타내는 0부터 시작하는 값입니다. RtlFindFirstRunClear가 명확한 비트 실행을 찾을 수 없는 경우 해당 값은 의미가 없습니다.

반환 값

RtlFindFirstRunClear 는 StartingIndex에서 시작하는 실행의 비트 수를 반환하거나 비트맵 내에서 명확한 비트 실행을 찾을 수 없는 경우 0을 반환합니다.

설명

반환된 실행에는 단일 지우기 비트가 있을 수 있습니다. 즉, 명확한 비트가 발견되면 RtlFindFirstRunClear 는 다음 집합 비트를 찾을 때까지 검색을 계속한 다음 찾은 실행에서 명확한 비트 수를 반환합니다.

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

요구 사항

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