Fonction RtlFindSetBits (wdm.h)

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

Syntaxe

NTSYSAPI ULONG RtlFindSetBits(
  [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 set contigus qui répondront à cette demande.

[in] HintIndex

Spécifie une position de bits de base zéro autour de laquelle commencer à rechercher une plage de bits définie de la taille donnée.

Valeur retournée

RtlFindSetBits retourne l’index de bits de départ de base zéro pour une plage de bits définie de la taille demandée, ou retourne 0xFFFFFFFF s’il ne trouve pas une telle plage dans la variable bitmap donnée.

Remarques

Pour un appel réussi, la position de bit retournée n’est pas nécessairement équivalente à la valeur HintIndex donnée. Si nécessaire, RtlFindSetBits recherche l’intégralité de la bitmap pour localiser une plage de bits définie de la taille demandée. Toutefois, il commence à rechercher la plage demandée près de HintIndex, de sorte que les appelants peuvent trouver une telle plage plus rapidement lorsqu’ils peuvent fournir des conseils appropriés sur l’endroit où commencer à rechercher.

Les appelants de RtlFindSetBits doivent être en cours d’exécution sur IRQL <= APC_LEVEL si la mémoire qui contient la variable bitmap est paginable ou la mémoire dans BitMapHeader est paginable. Sinon, RtlFindSetBits 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)

Voir aussi

RTL_BITMAP

RtlAreBitsSet

RtlClearBits

RtlFindClearBits

RtlFindSetBitsAndClear

RtlInitializeBitMap

RtlNumberOfSetBits