RtlAreBitsSet-Funktion (wdm.h)

Artikel
03/01/2024

Die RtlAreBitsSet-Routine bestimmt, ob ein bestimmter Bitbereich innerhalb einer Bitmapvariable festgelegt ist.

Syntax

NTSYSAPI BOOLEAN RtlAreBitsSet(
  [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 Start 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

RtlAreBitsSet gibt TRUE zurück, wenn aufeinanderfolgende Bits der Länge ab StartingIndex festgelegt sind (d. a. alle Bits von StartingIndex bis (StartingIndex + Length)). Es gibt FALSE zurück, wenn ein Bit im angegebenen Bereich eindeutig ist, wenn der angegebene Bereich keine richtige Teilmenge der Bitmap ist oder wenn die angegebene Länge 0 ist.

Hinweise

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