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