Fonction RtlFindFirstRunClear (wdm.h)
La routine RtlFindFirstRunClear recherche la plage contiguë initiale de bits clairs dans une bitmap donnée.
Syntaxe
NTSYSAPI ULONG RtlFindFirstRunClear(
[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 initiale dans la bitmap est retourné. Il s’agit d’une valeur de base zéro indiquant la position de bit du premier bit clair dans la plage retournée. Sa valeur n’a aucun sens si RtlFindFirstRunClear ne parvient pas à trouver une série de bits clairs.
Valeur retournée
RtlFindFirstRunClear retourne le nombre de bits dans l’exécution commençant à StartingIndex, ou zéro s’il ne trouve pas d’exécution de bits clairs dans la bitmap.
Remarques
Une exécution retournée peut avoir un seul bit clair. Autrement dit, une fois qu’un bit clair est trouvé, RtlFindFirstRunClear continue la recherche jusqu’à ce qu’il trouve le bit défini suivant, puis retourne le nombre de bits clairs dans l’exécution qu’il a trouvée.
Les appelants de RtlFindFirstRunClear 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, RtlFindFirstRunClear 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) |