RtlTestBit-Funktion (wdm.h)

Die RtlTestBit-Routine gibt den Wert eines Bits in einer Bitmap zurück.

Syntax

C++

NTSYSAPI BOOLEAN RtlTestBit(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       BitNumber
);

Parameter

[in] BitMapHeader

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

[in] BitNumber

Gibt den nullbasierten Index des Bits innerhalb der Bitmap an. Die Routine gibt den Wert dieses Bits zurück.

Rückgabewert

RtlTestBit gibt den Wert des Bits zurück, auf das der BitNumber-Parameter verweist.

Hinweise

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows XP und höheren Versionen von Windows.
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)

Weitere Informationen

RTL_BITMAP

RtlInitializeBitMap