Fonction RtlFindLongestRunClear (wdm.h)
La routine RtlFindLongestRunClear recherche la plus grande plage contiguë de bits clairs dans une bitmap donnée.
Syntaxe
NTSYSAPI ULONG RtlFindLongestRunClear(
[in] PRTL_BITMAP BitMapHeader,
[out] PULONG StartingIndex
);
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 .
[out] StartingIndex
Pointeur vers une variable dans laquelle l’index de départ de l’exécution en clair la plus longue dans la bitmap est retourné. Il s’agit d’une valeur de base zéro indiquant la position du premier bit clair dans la plage retournée.
Valeur retournée
RtlFindLongestRunClear retourne le nombre de bits dans l’exécution commençant à StartingIndex, ou zéro s’il ne trouve pas une exécution de bits clairs dans la bitmap.
Remarques
Une exécution retournée peut avoir un seul bit clair.
Les appelants de RtlFindLongestRunClear 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 sur BitMapHeader est paginable. Sinon, RtlFindLongestRunClear 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) |