Fonction RtlAreBitsSet (wdm.h)

Article
02/27/2024

La routine RtlAreBitsSet détermine si une plage donnée de bits dans une variable bitmap est définie.

Syntaxe

NTSYSAPI BOOLEAN RtlAreBitsSet(
  [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 qui indique la position du premier bit dans la plage.

[in] Length

Spécifie le nombre de bits à tester.

Valeur retournée

RtlAreBitsSet retourne TRUE si les bits de longueur consécutifs commençant à StartingIndex sont définis (autrement dit, tous les bits de StartingIndex à (StartingIndex + Length)). Elle retourne FALSE si un bit de la plage donnée est clair, 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 RtlAreBitsSet doivent être en cours d’exécution sur IRQL <= APC_LEVEL si la mémoire qui contient la variable bitmap est paginable ou si la mémoire de BitMapHeader est paginable. Sinon, RtlAreBitsSet peut être appelé au niveau de 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)