RtlAreBitsClear 函式 (wdm.h)

發行項
02/29/2024

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 (请参阅一节)