RtlFindLongestRunClear 函数 (wdm.h)

RtlFindLongestRunClear 例程在给定位图中搜索最大连续的明文位范围。

语法

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

[in] BitMapHeader

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

[out] StartingIndex

指向变量的指针，其中返回位图中最长清除运行的起始索引。这是一个从零开始的值，指示返回范围中第一个清除位的位位置。

RtlFindLongestRunClear 返回从 StartingIndex 开始的运行中的位数，如果无法在位图中找到明文位的运行，则返回零。

返回的运行可以有一个清除位。

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