RtlFindClearBits 函式 (wdm.h)

RtlFindClearBits 例程會搜尋點陣圖中要求大小的清除位範圍。

語法

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

[in] BitMapHeader

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

[in] NumberToFind

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

[in] HintIndex

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

RtlFindClearBits 會傳回至少要求大小的清除位範圍的以零起始的起始位索引，如果指定位圖內找不到這類範圍，則會傳回0xFFFFFFFF。

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

如果在提示索引與位圖結尾之間找不到相符的範圍， RtlFindClearBits 會 繼續從位圖開頭搜尋回提示索引。

如果您只想要傳回大於或等於某些值的索引，請改用 RtlFindNextForwardRunClear 。

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