Fonction RtlAreBitsClear (wdm.h)

Article
02/13/2024

La routine RtlAreBitsClear détermine si une plage donnée de bits au sein d’une variable bitmap est claire.

Syntaxe

NTSYSAPI BOOLEAN RtlAreBitsClear(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       Length
);

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 à tester. Il s’agit d’une valeur de base zéro indiquant la position du premier bit dans la plage.

[in] Length

Spécifie le nombre de bits à tester.

Valeur retournée

RtlAreBitsClear retourne TRUE si longueur des bits consécutifs commençant à StartingIndex sont clairs (autrement dit, tous les bits de StartingIndex à (Longueur d’index de démarrage + ) -1). Elle retourne FALSE si un bit de la plage donnée est défini, si la plage donnée n’est pas un sous-ensemble approprié de la bitmap ou si la longueur donnée est égale à zéro.

Remarques

Les appelants de RtlAreBitsClear 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, RtlAreBitsClear 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
IRQL	<= APC_LEVEL (voir la section Remarques)