RtlSetBits-Funktion (wdm.h)
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) |