rtlClearBits 函数 (wdm.h)

RtlClearBits 例程将位图中指定位范围内的所有位设置为零。

语法

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 参数为零， 则 RtlClearBits 仅返回控件而不清除任何位。

(StartingIndex + NumberToClear) 的总和不得超过初始化位图的 RtlInitializeBitMap 调用中指定的 SizeOfBitMap 参数值。

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