Fonction RtlFindNextForwardRunClear (wdm.h)
La routine RtlFindNextForwardRunClear recherche une variable bitmap donnée pour la série de bits vide suivante, à partir de la position d’index spécifiée.
Syntaxe
NTSYSAPI ULONG RtlFindNextForwardRunClear(
[in] PRTL_BITMAP BitMapHeader,
[in] ULONG FromIndex,
[out] PULONG StartingRunIndex
);
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] FromIndex
Spécifie une position de bit de base zéro à laquelle commencer à rechercher une série claire de bits.
[out] StartingRunIndex
Pointeur vers une variable dans laquelle l’index de départ de l’exécution en clair trouvé dans la bitmap est retourné. Il s’agit d’une valeur de base zéro indiquant la position de bit du premier bit clair de l’exécution. Sa valeur n’a aucun sens si RtlFindNextForwardRunClear ne peut pas trouver une exécution de bits clairs.
Valeur retournée
RtlFindNextForwardRunClear retourne soit le nombre de bits dans l’exécution commençant à StartingRunIndex, soit zéro s’il ne trouve pas une exécution de bits clairs après FromIndex dans la bitmap.
Remarques
Les appelants de RtlFindNextForwardRunClear doivent s’exécuter 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, RtlFindNextForwardRunClear 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) |