Fonction RtlFindLongestRunClear (wdm.h)

Article
03/01/2024

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)