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 (请参阅备注部分) |