RtlAreBitsClear 函数 (wdm.h)

RtlAreBitsClear 例程确定位图变量中的给定位范围是否清晰。

语法

NTSYSAPI BOOLEAN RtlAreBitsClear(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       Length
);

参数

[in] BitMapHeader

指向描述位图 的RTL_BITMAP 结构的指针。 此结构必须已由 RtlInitializeBitMap 例程初始化。

[in] StartingIndex

指定要测试的位范围的开头。 这是一个从零开始的值,指示范围中第一个位的位置。

[in] Length

指定要测试的位数。

返回值

如果从 StartingIndex 开始的长度连续位明确 (即从 StartingIndex 到 (StartingIndex + 长度) -1) ,则 RtlAreBitsClear 返回 TRUE。 如果设置了给定范围中的任何位,如果给定范围不是位图的正确子集,或者给定的 Length 为零,则返回 FALSE

注解

如果包含位图变量的内存可分页或 BitMapHeader 上的内存可分页,则 RtlAreBitsClear 的调用方必须在 IRQL <= APC_LEVEL 运行。 否则,可以在任何 IRQL 中调用 RtlAreBitsClear

要求

要求
最低受支持的客户端 从 Windows 2000 开始可用。
目标平台 通用
标头 wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL (请参阅备注部分)

另请参阅

RTL_BITMAP

RtlAreBitsSet

RtlCheckBit

RtlClearAllBits

RtlFindClearBits

RtlFindFirstRunClear

RtlFindLastBackwardRunClear

RtlFindLongestRunClear

RtlFindNextForwardRunClear

RtlInitializeBitMap