RtlAreBitsClear-Funktion (wdm.h)

Artikel
03/01/2024

Die RtlAreBitsClear-Routine bestimmt, ob ein bestimmter Bitbereich innerhalb einer Bitmapvariable eindeutig ist.

Syntax

NTSYSAPI BOOLEAN RtlAreBitsClear(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       Length
);

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

Gibt den Anfang des zu testenden Bitbereichs an. Dies ist ein nullbasierter Wert, der die Position des ersten Bits im Bereich angibt.

[in] Length

Gibt an, wie viele Bits getestet werden sollen.

Rückgabewert

RtlAreBitsClear gibt TRUE zurück, wenn aufeinanderfolgende Bits der Länge, die bei StartingIndex beginnen, klar sind (d. a. alle Bits von StartingIndex bis (StartingIndex + Length) -1). Es gibt FALSE zurück, wenn ein Bit im angegebenen Bereich festgelegt ist, wenn der angegebene Bereich keine richtige Teilmenge der Bitmap ist oder wenn die angegebene Länge null ist.

Hinweise

Aufrufer von RtlAreBitsClear müssen unter IRQL <= APC_LEVEL ausgeführt werden, wenn der Speicher, der die Bitmapvariable enthält, ausgelagert werden kann oder der Speicher bei BitMapHeader ausgelagert werden kann. Andernfalls kann RtlAreBitsClear in 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")