Fonction RtlFindClearBits (wdm.h)

Article
02/27/2024

La routine RtlFindClearBits recherche une plage de bits clairs d’une taille demandée dans une bitmap.

Syntaxe

NTSYSAPI ULONG RtlFindClearBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       NumberToFind,
  [in] ULONG       HintIndex
);

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] NumberToFind

Spécifie le nombre de bits clairs contigus qui répondront à cette demande.

[in] HintIndex

Spécifie une position de bit de base zéro à partir de laquelle commencer à rechercher une plage de bits claire de la taille donnée.

Valeur retournée

RtlFindClearBits retourne l’index de bits de départ de base zéro pour une plage de bits claires d’au moins la taille demandée, ou renvoie 0xFFFFFFFF s’il ne parvient pas à trouver une telle plage dans l’image bitmap donnée.

Remarques

Pour un appel réussi, la position de bits retournée n’est pas nécessairement équivalente à la valeur HintIndex donnée. Si nécessaire, RtlFindClearBits recherche l’ensemble de l’image bitmap pour rechercher une plage de bits claire de la taille demandée. Les appelants peuvent trouver une telle plage plus rapidement lorsqu’ils peuvent fournir des conseils appropriés sur l’endroit où commencer à rechercher.

Si aucune plage correspondante n’est trouvée entre l’index d’indicateur et la fin de la bitmap, RtlFindClearBits continue la recherche depuis le début de la bitmap jusqu’à l’index d’indicateur.

Si vous souhaitez uniquement retourner un index supérieur ou égal à une valeur, utilisez plutôt RtlFindNextForwardRunClear .

Les appelants de RtlFindClearBits 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, RtlFindClearBits peut être appelé à n’importe quel IRQL.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	IRQL <= APC_LEVEL (voir la section Remarques)