RtlFindSetBitsAndClear 函式 (wdm.h)
RtlFindSetBitsAndClear 例程會搜尋點陣圖內要求大小的集合位範圍，並在找到該位時清除範圍中的所有位。
語法
NTSYSAPI ULONG RtlFindSetBitsAndClear(
[in] PRTL_BITMAP BitMapHeader,
[in] ULONG NumberToFind,
[in] ULONG HintIndex
);
參數
[in] BitMapHeader
描述位圖之 RTL_BITMAP 結構的指標。 此結構必須由 RtlInitializeBitMap 例程初始化。
[in] NumberToFind
指定可滿足此要求的連續設定位數目。
[in] HintIndex
指定要開始尋找指定大小的設定位範圍之以零起始的位位置。
傳回值
RtlFindSetBitsAndClear 會針對所清除之要求大小的設定位範圍，傳回以零起始的起始位索引，如果它找不到指定位變數內的這類範圍，則會傳回0xFFFFFFFF。
備註
針對成功的呼叫，傳回的位位置不一定等於指定的 HintIndex。 如有必要， RtlFindSetBitsAndClear 會搜尋整個位圖，以找出所要求大小的設定位範圍。 不過，它會開始搜尋 接近HintIndex的要求範圍，因此當呼叫端可以提供適當提示開始查看的位置時，可以更快速地清除這類範圍。
RtlFindSetBitsAndClear 的呼叫端必須在 IRQL <= APC_LEVEL，如果包含位圖變數的記憶體可分頁或 BitMapHeader 的記憶體可分頁。 否則，任何 IRQL 都可以呼叫 RtlFindSetBitsAndClear 。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL (请参阅一节) |