RtlClearBits-Funktion (wdm.h)
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"). |