RtlSetBits-Funktion (wdm.h)

Artikel
02/27/2024

Die RtlSetBits-Routine legt alle Bits in einem bestimmten Bereich einer bestimmten Bitmapvariable fest.

Syntax

NTSYSAPI VOID RtlSetBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       NumberToSet
);

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 festzulegenden Bitbereichs an. Dies ist ein nullbasierter Wert, der die Position des ersten Bits im Bereich angibt.

[in] NumberToSet

Gibt an, wie viele Bits festgelegt werden sollen.

Rückgabewert

Keine

Bemerkungen

RtlSetBits gibt einfach das Steuerelement zurück, wenn die Eingabe NumberToSet 0 ist. StartingIndex plus NumberToSet müssen kleiner oder gleich BitMapHeader-SizeOfBitMap> sein.

Aufrufer von RtlSetBits 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 RtlSetBits 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 (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL	<= APC_LEVEL (siehe Abschnitt Hinweise)