RtlClearBits 함수(wdm.h)

아티클
03/01/2024

RtlClearBits 루틴은 비트맵에서 지정된 비트 범위의 모든 비트를 0으로 설정합니다.

구문

NTSYSAPI VOID RtlClearBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       NumberToClear
);

매개 변수

[in] BitMapHeader

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

[in] StartingIndex

지울 비트 범위의 첫 번째 비트 인덱스입니다. 비트맵에 N 비트가 포함된 경우 비트의 번호는 0에서 N-1로 지정됩니다.

[in] NumberToClear

지울 비트 수를 지정합니다. 비트맵에 N 비트가 포함된 경우 이 매개 변수는 1에서 (N - StartingIndex) 범위의 값일 수 있습니다.

반환 값

이 루틴은 값을 반환하지 않습니다.

설명

NumberToClear 매개 변수가 0이면 RtlClearBits는 비트를 지우지 않고 컨트롤을 반환합니다.

합계(StartingIndex + NumberToClear)는 비트맵을 초기화한 RtlInitializeBitMap 호출에 지정된 SizeOfBitMap 매개 변수 값을 초과하면 안 됩니다.

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

요구 사항

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