共用方式為


rtlFindClearBitsAndSet 函式 (wdm.h)

RtlFindClearBitsAndSet 例程會搜尋點陣圖中要求大小的清除位範圍,並在找到位圖時設定範圍中的所有位。

語法

NTSYSAPI ULONG RtlFindClearBitsAndSet(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       NumberToFind,
  [in] ULONG       HintIndex
);

參數

[in] BitMapHeader

描述位圖之 RTL_BITMAP 結構的指標。 此結構必須由 RtlInitializeBitMap 例程初始化。

[in] NumberToFind

指定滿足此要求的連續清除位數目。

[in] HintIndex

指定要開始尋找指定大小的清楚位範圍之以零起始的位位置。

傳回值

RtlFindClearBitsAndSet 會傳回以零起始的起始位索引,以取得它所設定之大小清楚的位範圍,如果它找不到指定位變數內的這類範圍,則會傳回0xFFFFFFFF。

備註

針對成功的呼叫,傳回的位位置不一定等於指定的 HintIndex。 如有必要, RtlFindClearBitsAndSet 會搜尋整個位圖,以找出要求大小的清楚位範圍。 不過,它會從 HintIndex開始搜尋要求的範圍,因此當呼叫端可以提供適當提示來開始查看的位置時,可以更快速地重設這類範圍。

RtlFindClearBitsAndSet 的呼叫端必須在 IRQL <= APC_LEVEL 如果包含位圖變數的記憶體可分頁,或是 BitMapHeader 的記憶體可分頁。 否則,任何 IRQL 都可以呼叫 RtlFindClearBitsAndSet

規格需求

需求
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= APC_LEVEL (请参阅一节)

另請參閱

RTL_BITMAP

RtlAreBitsClear

RtlFindClearBits

RtlFindClearRuns

RtlFindFirstRunClear

RtlFindLastBackwardRunClear

RtlFindLongestRunClear

RtlFindNextForwardRunClear

RtlInitializeBitMap

RtlNumberOfClearBits

RtlSetAllBits

RtlSetBits