RtlCheckBit-Makro (wdm.h)

Artikel
02/27/2024

Die RtlCheckBit-Routine bestimmt, ob ein bestimmtes Bit in einer bestimmten Bitmapvariable eindeutig oder festgelegt ist.

Syntax

BOOLEAN RtlCheckBit(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       BitPosition
);

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] BitPosition

Gibt an, welches Bit überprüft werden soll. Dies ist ein nullbasierter Wert, der die Position des zu testenden Bits angibt.

Rückgabewert

RtlCheckBit gibt null zurück, wenn das angegebene Bit eindeutig ist, oder eines, wenn das angegebene Bit festgelegt ist.

Hinweise

Aufrufer von RtlCheckBit 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 RtlCheckBit in jedem IRQL aufgerufen werden.

Anforderungen

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