(wdm.h) RtlFindClearRuns 函式
RtlFindClearRuns 例程會尋找指定位圖內清除位的指定執行數目。
語法
NTSYSAPI ULONG RtlFindClearRuns(
[in] PRTL_BITMAP BitMapHeader,
[out] PRTL_BITMAP_RUN RunArray,
[in] ULONG SizeOfRunArray,
[in] BOOLEAN LocateLongestRuns
);
參數
[in] BitMapHeader
描述位圖 之RTL_BITMAP 結構的指標。 此結構必須由 RtlInitializeBitMap 例程初始化。
[out] RunArray
呼叫端配置陣列中第一個專案的指標，用於指定位位位置和指定位陣圖變數中找到的每個清除執行長度。
[in] SizeOfRunArray
指定要滿足此要求的清除執行數目上限。
[in] LocateLongestRuns
如果為 TRUE，則指定例程是要搜尋整個點陣圖，以尋找最長的清除執行。 否則，例程會在找到 SizeOfRunArray 所指定的清除執行次數時停止搜尋。
傳回值
RtlFindClearRuns 會傳回找到的清除執行數目。
備註
如果 LocateLongestRuns 為 TRUE， 則 RunArray 所指出的清除執行會從最長到最短排序。 清除執行可以包含單一位。
如果包含位圖變數的記憶體可分頁或 BitMapHeader 的記憶體可分頁，則 RtlFindClearRuns 的呼叫端必須在 IRQL <= APC_LEVEL。 否則，任何 IRQL 都可以呼叫 RtlFindClearRuns 。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL (请参阅一节) |