Fonction RtlSetBits (wdm.h)

Article
02/27/2024

La routine RtlSetBits définit tous les bits d’une plage donnée d’une variable bitmap donnée.

Syntaxe

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

Paramètres

[in] BitMapHeader

Pointeur vers la structure RTL_BITMAP qui décrit la bitmap. Cette structure doit avoir été initialisée par la routine RtlInitializeBitMap .

[in] StartingIndex

Spécifie le début de la plage de bits à définir. Il s’agit d’une valeur de base zéro indiquant la position du premier bit dans la plage.

[in] NumberToSet

Spécifie le nombre de bits à définir.

Valeur de retour

None

Remarques

RtlSetBits retourne simplement le contrôle si l’entrée NumberToSet est égale à zéro. StartingIndex plus NumberToSet doit être inférieur ou égal à BitMapHeader-SizeOfBitMap>.

Les appelants de RtlSetBits doivent être en cours d’exécution dans IRQL <= APC_LEVEL si la mémoire qui contient la variable bitmap est paginable ou si la mémoire de BitMapHeader est paginable. Sinon, RtlSetBits peut être appelé à n’importe quel IRQL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur)
IRQL	<= APC_LEVEL (voir la section Remarques)