RtlClearBits-Funktion (wdm.h)

Artikel
02/29/2024

Die RtlClearBits-Routine legt alle Bits im angegebenen Bitbereich in der Bitmap auf 0 (null) fest.

Syntax

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

Parameter

[in] BitMapHeader

Ein Zeiger auf die RTL_BITMAP-Struktur , die die Bitmap beschreibt. Diese Struktur muss von der RtlInitializeBitMap-Routine initialisiert worden sein.

[in] StartingIndex

Der Index des ersten Bits im Zu löschenden Bitbereich. Wenn die Bitmap N Bits enthält, werden die Bits von 0 bis N-1 nummeriert.

[in] NumberToClear

Gibt an, wie viele Bits gelöscht werden sollen. Wenn die Bitmap N Bits enthält, kann dieser Parameter ein Wert im Bereich von 1 bis (N – StartingIndex) sein.

Rückgabewert

Diese Routine gibt keinen Wert zurück.

Hinweise

Wenn der NumberToClear-Parameter null ist, gibt RtlClearBits einfach die Steuerung zurück, ohne Bits zu löschen.

Die Summe (StartingIndex + NumberToClear) darf den SizeOfBitMap-Parameterwert nicht überschreiten, der im RtlInitializeBitMap-Aufruf angegeben ist, der die Bitmap initialisiert hat.

Aufrufer von RtlClearBits müssen unter IRQL <= APC_LEVEL ausgeführt werden, wenn der Speicher, der die Bitmap enthält, ausgelagert werden kann oder der Arbeitsspeicher in BitMapHeader ausgelagert werden kann. Andernfalls kann RtlClearBits an jedem IRQL aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL (siehe Abschnitt "Hinweise").