Fonction RtlAreBitsClear (wdm.h)
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) |