RtlFindNextForwardRunClear 函数 (wdm.h)

RtlFindNextForwardRunClear 例程从指定的索引位置开始,搜索给定位图变量的下一个清除运行。

语法

NTSYSAPI ULONG RtlFindNextForwardRunClear(
  [in]  PRTL_BITMAP BitMapHeader,
  [in]  ULONG       FromIndex,
  [out] PULONG      StartingRunIndex
);

参数

[in] BitMapHeader

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

[in] FromIndex

指定从零开始的位位置,从该位置开始查找明确的位运行。

[out] StartingRunIndex

指向变量的指针,在该变量中返回位图中找到的清除运行的起始索引。 这是一个从零开始的值,指示运行中第一个清除位的位位置。 如果 RtlFindNextForwardRunClear 找不到明文位的运行,则其值毫无意义。

返回值

RtlFindNextForwardRunClear 返回从 StartingRunIndex 开始的运行中的位数;如果位图中找不到 FromIndex 后面的明文位的运行,则返回零。

注解

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

要求

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

另请参阅

RTL_BITMAP

RtlAreBitsClear

RtlFindClearBits

RtlFindClearRuns

RtlFindFirstRunClear

RtlFindLastBackwardRunClear

RtlFindLongestRunClear

RtlInitializeBitMap