Fonction RtlFindFirstRunClear (wdm.h)

Article
02/29/2024

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)