(wdm.h) RtlClearBits 函式

RtlClearBits 例程會將點陣圖中指定位範圍中的所有位設定為零。

語法

NTSYSAPI VOID RtlClearBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       NumberToClear
);

[in] BitMapHeader

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

[in] StartingIndex

要清除之位範圍中第一個位的索引。如果點圖包含 N 位，則位會從 0 編號為 N-1。

[in] NumberToClear

指定要清除的位數。如果點圖包含 N 位，則此參數可以是範圍 1 中的值，以 (N - StartingIndex) 。

這個例程不會傳回值。

如果 NumberToClear 參數為零， RtlClearBits 只會傳回控件而不清除任何位。

StartingIndex + NumberToClear (總和) 不能超過初始化位圖之 RtlInitializeBitMap 呼叫中指定的 SizeOfBitMap 參數值。

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