RtlAreBitsClear 函式 (wdm.h)
RtlAreBitsClear 例程會判斷位圖變數內的指定位範圍是否清楚。
語法
NTSYSAPI BOOLEAN RtlAreBitsClear(
[in] PRTL_BITMAP BitMapHeader,
[in] ULONG StartingIndex,
[in] ULONG Length
);
參數
[in] BitMapHeader
描述位圖之 RTL_BITMAP 結構的指標。 此結構必須由 RtlInitializeBitMap 例程初始化。
[in] StartingIndex
指定要測試的位範圍開始。 這是以零起始的值,表示範圍中第一個位的位置。
[in] Length
指定要測試多少位。
傳回值
RtlAreBitsClear 如果 StartingIndex 開頭的長度連續位清楚 (為 TRUE,也就是 StartingIndex (到 startingIndex + 長度) -1) 的所有位。 如果已設定指定範圍中的任何位、指定的範圍不是位圖的適當子集,或指定的 Length 為零,則會傳回 FALSE。
備註
RtlAreBitsClear 的呼叫端必須在 IRQL <= APC_LEVEL如果包含位陣圖變數的記憶體可分頁,或是 BitMapHeader 的記憶體可分頁。 否則,任何 IRQL 都可以呼叫 RtlAreBitsClear 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平台 | Universal |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | <= APC_LEVEL (请参阅一节) |