Fonction RtlClearBits (wdm.h)

Article
02/27/2024

La routine RtlClearBits définit tous les bits de la plage de bits spécifiée dans la bitmap sur zéro.

Syntaxe

NTSYSAPI VOID RtlClearBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       NumberToClear
);

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

Index du premier bit de la plage de bits à effacer. Si la bitmap contient N bits, les bits sont numérotés de 0 à N-1.

[in] NumberToClear

Spécifie le nombre de bits à effacer. Si la bitmap contient N bits, ce paramètre peut être une valeur dans la plage de 1 à (N - StartingIndex).

Valeur retournée

Cette routine ne retourne pas de valeur.

Remarques

Si le paramètre NumberToClear est égal à zéro, RtlClearBits retourne simplement le contrôle sans effacer les bits.

La somme (StartingIndex + NumberToClear) ne doit pas dépasser la valeur du paramètre SizeOfBitMap spécifiée dans l’appel RtlInitializeBitMap qui a initialisé la bitmap.

Les appelants de RtlClearBits doivent être en cours d’exécution sur IRQL <= APC_LEVEL si la mémoire qui contient la bitmap est paginable ou si la mémoire de BitMapHeader est paginable. Sinon, RtlClearBits 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 (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL (voir la section Notes.)