wdm.h) (RtlFindFirstRunClear 函式

RtlFindFirstRunClear 例程會搜尋指定位圖內的初始連續位範圍。

語法

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

[in] BitMapHeader

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

[out] StartingIndex

變數的指標，其中會傳回位圖中初始清除執行的起始索引。這是以零起始的值，表示傳回範圍中第一個清除位的位位置。如果 RtlFindFirstRunClear 找不到清除位的執行，其值就無意義。

RtlFindFirstRunClear 會傳回從 StartingIndex 開始執行中的位數，如果它找不到位圖內的清除位執行，則傳回零。

傳回的執行可以有單一清除位。也就是說，找到清除位之後， RtlFindFirstRunClear 會繼續搜尋直到找到下一個設定位為止，然後傳回所找到的執行中清除位的數目。

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